Reorganize site with modern landing page and interactive SQL demo

[sdanyliv]

Summary

• Reorganize site into three main sections: Documentation, Articles, API
• Modern landing page with gradient hero, .NET Foundation badge, and interactive SQL demo
• 7 tabbed demo examples showing real SQL generated by linq2db: Query, Associations, ExpressionMethod, CTE, Window Functions, Merge, Temp Table
• Edit this page links enabled for documentation pages (disabled for auto-generated API docs)
• Maintenance guide for rebuilding/extending demo tabs at tools/sql-demo/README.md

Screenshots

Dark Mode

Light Mode

Test plan

• Verify all 7 demo tabs switch correctly
• Check Documentation, Articles, API navigation links work
• Verify edit links appear on documentation pages but not API pages
• Test responsive layout on mobile/tablet viewports
• Verify dark/light mode theme switching

🤖 Generated with Claude Code

[MaceWindu]

Review of the site reorg + landing page. Structure is sound — pure-CSS radio/label tabs (7 inputs ↔ 7 panels ↔ 7 :checked pairs, all consistent), dark/light via Bootstrap CSS vars, clean renames (articles/ → documentation/), net-zero submodule change. Two blocking items, rest is polish.

---

BLOCKING · 1 — Remove the .NET Foundation Member badge

linq2db has retired from the .NET Foundation, so this hero badge in source/index.md is now a false claim (only .NET Foundation reference in the PR):

-<a href="https://dotnetfoundation.org/" class="landing-badge mb-3"><i class="bi bi-patch-check-fill"></i> .NET Foundation Member</a>

Drop the anchor. The .landing-badge rules in main.css then go unused — delete them too, or repurpose the badge for something current (MIT / Open Source).

---

BLOCKING · 2 — SqlDemoGenerator.TempTableDemo can't reproduce the Temp Table tab

tools/sql-demo/README.md presents SqlDemoGenerator.cs as the reproducible source of the displayed SQL. But TempTableDemo() is a group-by aggregation with no temp table at all — unrelated to the tab, which shows CreateTempTable("#FilterIds", …) + BulkCopy + join. A maintainer copying it back per the guide gets wrong output. Either implement the real CreateTempTable path or remove the method and state in the guide that this tab has no generator.

---

MINOR · 3 — WindowFunctions generator drifts from its tab

WindowFunctions() computes three window columns (RowNum, Rank, Total); the tab shows only RowNum and Total. Align them.

MINOR · 4 — MergeDemo calls ToSqlQuery on the un-finalized builder

The tab code ends with .Merge(); the generator omits it and calls merge.ToSqlQuery(...) on the IMergeable builder. Confirm that path actually emits the displayed MERGE INTO … — otherwise it's another non-reproducing reference.

MINOR · 5 — "Real SQL" claim is fragile

The displayed SQL is hand-re-indented HTML; nothing keeps it in sync with the generator after merge. Soften the README from "real output" to "based on real output, hand-formatted."

MINOR · 6 — Edit-link suppression covers .yml only

docfx.json fileMetadata._disableContribution targets api/**/**.yml. The PR body says edit links are disabled for auto-generated API docs — confirm API output is yml-only, else any generated api/**/*.md / toc.yml still renders an edit link to uneditable content.

---

Nits

• A11y: radio/label tabs work with arrow keys but lack role="tablist/tab/tabpanel" / aria-selected; screen readers announce them as radios.
• Order entity and Product.CreatedAt in SqlDemoGenerator.cs are unused.

[igor-tkachev]

The new site structure and landing page are useful, but this PR should not be merged in its current state.

Blocking issues

1. Preserve redirects for all moved documentation pages

Moving the documentation tree from source/articles/ to source/documentation/ changes the public URL of nearly every existing documentation page. For example:

/articles/CLI.html
/articles/sql/Bulk-Copy.html
/articles/get-started/install/index.html

become:

/documentation/CLI.html
/documentation/sql/Bulk-Copy.html
/documentation/get-started/install/index.html

This breaks incoming links from GitHub issues, Stack Overflow, external articles, search results, package documentation, and bookmarks. Navigation can be reorganized without changing the physical paths. If the directory move is retained, redirects must be generated for every moved page.

DocFX supports a redirections.yml file. For example:

redirections:
  - source_path: articles/CLI.md
    redirect_url: /documentation/CLI.html

  - source_path: articles/sql/Bulk-Copy.md
    redirect_url: /documentation/sql/Bulk-Copy.html

  - source_path: articles/get-started/install/index.md
    redirect_url: /documentation/get-started/install/index.html

Include the file in the DocFX build content, e.g.:

{
  "files": [
    "api/**/*.{md,yml}",
    "articles/**/*.{md,yml}",
    "documentation/**/*.{md,yml}",
    "redirections.yml",
    "toc.yml",
    "*.md"
  ]
}

The complete redirect list can be generated mechanically from the renamed files in this PR. Please also verify the generated site locally by opening several old URLs and checking that they resolve to the corresponding new pages.

2. Remove the .NET Foundation Member badge

linq2db is no longer a .NET Foundation member, so this is now a false claim:

<a href="https://dotnetfoundation.org/" class="landing-badge mb-3">
  <i class="bi bi-patch-check-fill"></i> .NET Foundation Member
</a>

Remove it and remove or repurpose the now-unused .landing-badge CSS.

3. SqlDemoGenerator.TempTableDemo does not reproduce the Temp Table tab

tools/sql-demo/README.md presents SqlDemoGenerator.cs as the reproducible source for the displayed SQL, but TempTableDemo() contains a normal join/grouping query and does not create a temporary table at all. The landing-page tab instead shows CreateTempTable("#FilterIds", ...), BulkCopy, a join against the temp table, and disposal.

Implement the actual temp-table scenario in the generator, or explicitly document that this tab is maintained manually and cannot be regenerated by the provided test.

Other issues

4. The Window Functions generator already differs from the displayed example

WindowFunctions() generates RowNum, Rank, and Total, while the landing-page example contains only RowNum and Total. Align them. This existing drift also shows that manually synchronizing the generator, C# HTML, and SQL HTML is fragile.

5. Soften the “real generated SQL” claim or make synchronization enforceable

The SQL embedded in source/index.md is manually copied, reformatted, and decorated with HTML markup. Nothing verifies it against the generator during the build, and examples in this PR already differ from it. Unless generation is automated or snapshot-verified, describe these as examples based on SQL generated by linq2db rather than guaranteed current output.

6. Verify that MergeDemo generates the displayed statement

The landing-page chain ends with the final .Merge() call, but the generator stores the intermediate builder after InsertWhenNotMatched() and calls ToSqlQuery() on it. Confirm that this is a supported path and produces exactly the shown MERGE INTO statement; otherwise finalize the builder consistently.

7. API edit-link suppression appears too narrow

fileMetadata._disableContribution currently targets only:

"api/**/**.yml": true

The PR description states that edit links are disabled for all generated API pages. Verify generated .md, API toc.yml, landing pages, and the glob behavior in the custom DocFX version. Prefer a pattern that covers the entire generated API tree if supported.

8. Improve tab accessibility

The radio/label implementation works visually, but assistive technology sees radio controls rather than tabs. The markup lacks tablist/tab/tabpanel semantics and related ARIA relationships. Please either implement accessible tab behavior or explicitly use a component whose keyboard and screen-reader behavior can be tested.