Move links to left nav bar, import analyzer rules

Author: bradwilson

.gitignore

@@ -1,4 +1,5 @@
 .site/
+_exported_templates/
 node_modules/
 bin/
 obj/

package-lock.json

@@ -31,9 +31,13 @@
     "globalMetadata": {
       "_appName": "xUnit.net",
       "_appTitle": "xUnit.net",
-      "_appFooter": "<div class=\"align-right\"><a href=\"https://github.com/xunit/xunit.net\">Contribute to the documentation</a></div>Copyright &copy; <a href=\"https://dotnetfoundation.org/\">.NET Foundation</a>. Made with <a href=\"https://github.com/dotnet/docfx\">DocFX</a>.",
+      "_appFooter": "Copyright &copy; <a href='https://dotnetfoundation.org/'>.NET Foundation</a>. Site built with <a href='https://github.com/dotnet/docfx'>DocFX</a>. Contributions welcomed at <a href='https://github.com/xunit/xunit.net'>https://github.com/xunit/xunit.net</a>.",
       "_appFaviconPath": "images/logo-128-transparent.png",
+      "_disableBreadcrumb": true,
+      "_disableNavbar": true,
+      "_disableNextArticle": true,
       "_disableToc": false,
+      "_enableNewTab": true,
       "_enableSearch": true,
       "pdf": false
     },

site/docfx.json

@@ -1,7 +1,5 @@
 ---
-layout: default
 title: Governance
-breadcrumb: Governance
 ---
 
 # Governance

site/governance.md

@@ -10,21 +10,14 @@ xUnit.net is a free, open source, community-focused unit testing tool for C#, F#
 
 xUnit.net works with the [.NET SDK](https://dotnet.microsoft.com/download) command line tools, [Visual Studio](https://visualstudio.microsoft.com/), [Visual Studio Code](https://code.visualstudio.com/), [JetBrains Rider](https://www.jetbrains.com/rider/), [NCrunch](https://www.ncrunch.net/), and any development environment compatible with [Microsoft Testing Platform](https://learn.microsoft.com/dotnet/core/testing/microsoft-testing-platform-intro) or [VSTest](https://github.com/microsoft/vstest).
 
-xUnit.net is part of the [.NET Foundation](https://www.dotnetfoundation.org/) and operates under their [code of conduct](https://www.dotnetfoundation.org/code-of-conduct). It is licensed under [Apache 2](https://opensource.org/licenses/Apache-2.0) (an OSI approved license).
+xUnit.net is part of the [.NET Foundation](https://www.dotnetfoundation.org/) and operates under their [code of conduct](https://www.dotnetfoundation.org/code-of-conduct). It is licensed under [Apache 2](https://opensource.org/licenses/Apache-2.0) (an OSI approved license). The project is [governed](/governance) by a Project Lead.
 
 { .about-links }
 > Follow: <a href="https://dotnet.social/@xunit" rel="me">xUnit.net on Mastodon</a>, [xUnit.net on BlueSky](https://bsky.app/@xunit.net), [Brad Wilson](https://bradwilson.dev/), [James Newkirk](https://www.jamesnewkirk.com/), [Claire Novotny](https://github.com/clairernovotny)<br />
 > JetBrains Rider support is provided and supported by [JetBrains](https://www.jetbrains.com/).<br />
 > NCrunch support is provided and supported by [Remco Software](https://www.ncrunch.net/).<br />
 > The xUnit.net logo was designed by [Nathan Young](https://mas.to/@nathanyoung).
 
-
-- [Quick Start with .NET SDK](#quick-start-with-net-sdk)
-- [Documentation](#documentation)
-- [Issues and Discussions](#issues-and-discussions)
-- [Release Notes](#release-notes)
-- [Latest Builds](#latest-builds)
-
 ## Quick Start with .NET SDK
 
 ### [C#](#tab/cs)
@@ -257,74 +250,12 @@ xUnit.net v3 In-Process Runner v2.0.3+216a74a292 (64-bit .NET 8.0.17)
 
 ---
 
-## Documentation
-
-### Getting Started
-
-* [Getting started with the .NET SDK command line](/docs/v3/getting-started)<br />
-  _Includes running tests from the command line, Visual Studio, Visual Studio Code, and JetBrains Rider_
-* [API documentation](https://api.xunit.net/)
-* [xUnit.net analyzer documentation](/xunit.analyzers/rules/)
-* [Query filter language](/docs/v3/query-filter-language)
-* [NuGet packages](/docs/v3/nuget-packages)
-* [Configuration with `xunit.runner.json`](/docs/configuration-files)
-* [Sample projects (including testing and extensibility)](https://github.com/xunit/samples.xunit)
-
-### Migrating from xUnit.net v2
-
-* [What's new in xUnit.net v3?](/docs/v3/whats-new)
-* Migrating from xUnit.net v2 [for unit test authors](/docs/v3/migration) and [extensibility authors](/docs/v3/migration-extensibility)
-
-### Unit Test Parallelism
-
-* [Running tests in parallel](/docs/running-tests-in-parallel)
-* [Sharing context between tests](/docs/shared-context) (class, collection, and assembly fixtures)
-
-### Microsoft Testing Platform
-
-* [Microsoft Testing Platform support](/docs/v3/microsoft-testing-platform)
-* [Code Coverage with Microsoft Testing Platform](/docs/v3/code-coverage-with-mtp)
-* [Configuration with `testconfig.json` with Microsoft Testing Platform](/docs/v3/testconfig-json)
-
-### VSTest and `xunit.runner.visualstudio`
-
-* [Configuration with RunSettings](/docs/runsettings)
-
-### Test Results in CI Systems
-
-* [Getting Test Results in Azure DevOps](/docs/getting-test-results-in-azure-devops)
-* [Getting Test Results in TeamCity](/docs/getting-test-results-in-teamcity)
-* [Getting Test Results in CruiseControl.NET](/docs/getting-test-results-in-ccnet)
-
-### Frequently Asked Questions
-
-* [How do I use a CI build NuGet package?](/docs/using-ci-builds)
-* [What is the JSON schema for `xunit.runner.json`?](/schema/)
-* [What is the format of the XML generated by the test runners?](/docs/format-xml-v2)
-* [How do I build xUnit.net?](https://github.com/xunit/xunit/blob/main/BUILDING.md)
-* [Why doesn't xUnit.net support netstandard?](/docs/why-no-netstandard)
-* [What is "theory data stability"?](/docs/theory-data-stability-in-vs)
-
-### Advanced topics
-
-* [Capturing output](/docs/capturing-output)
-* [Serialization with `IXunitSerializer` and `IXunitSerializable`](/docs/custom-serialization)
-* [Writing a custom Runner Reporter](/docs/custom-runner-reporter)
-* [Multi-targeting on non-Windows OSes](/docs/getting-started/multi-target/non-windows)
-* [Equality with hash sets vs. linear containers](/docs/hash-sets-vs-linear-containers)
-
-## Issues and Discussions
-
-* Issues in the core framework and analyzers should be reported in the [primary issue tracker](https://github.com/xunit/xunit/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)
-* Issues in `xunit.runner.visualstudio` should be reported in the [project issue tracker](https://github.com/xunit/visualstudio.xunit/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)
-* Discussions are hosted in the [primary discussion forums](https://github.com/xunit/xunit/discussions?discussions_q=is%3Aunanswered+is%3Aopen)
-
 ## Release Notes
 
 {: .latest }
 |                           | Stable                                             | Prerelease                                                       |
 | ------------------------- | -------------------------------------------------- | ---------------------------------------------------------------- | -------------------------------
-| xunit.v3                  | [2.0.3](/releases/v3/2.0.3){: .release }           | [3.0.0-pre.25](/releases/v3/3.0.0-pre.25){: .prerelease }        | ([all releases](/releases/v3/))
+| xunit.v3                  | [2.0.3](/releases/2.0.3){: .release }           | [3.0.0-pre.25](/releases/3.0.0-pre.25){: .prerelease }        | ([all releases](/releases/))
 | xunit.analyzers           | [1.22.0](/releases/analyzers/1.22.0){: .release }  | [1.23.0-pre.3](/releases/analyzers/1.23.0-pre.3){: .prerelease } | ([all releases](/releases/analyzers/))
 | xunit.runner.visualstudio | [3.1.1](/releases/visualstudio/3.1.1){: .release } |                                                                  | ([all releases](/releases/visualstudio/))
 
@@ -336,3 +267,9 @@ xUnit.net v3 In-Process Runner v2.0.3+216a74a292 (64-bit .NET 8.0.17)
 | xunit.v3                  | [![](https://img.shields.io/nuget/v/xunit.v3.svg?logo=nuget)](https://www.nuget.org/packages/xunit.v3)                                   | [![](https://img.shields.io/badge/endpoint.svg?url=https://f.feedz.io/xunit/xunit/shield/xunit.v3/latest&color=f58142)](https://feedz.io/org/xunit/repository/xunit/packages/xunit.v3)                                   | [![](https://img.shields.io/endpoint.svg?url=https://actions-badge.atrox.dev/xunit/xunit/badge%3Fref%3Dmain&amp;label=build)](https://actions-badge.atrox.dev/xunit/xunit/goto?ref=main)
 | xunit.analyzers           | [![](https://img.shields.io/nuget/v/xunit.analyzers.svg?logo=nuget)](https://www.nuget.org/packages/xunit.analyzers)                     | [![](https://img.shields.io/badge/endpoint.svg?url=https://f.feedz.io/xunit/xunit/shield/xunit.analyzers/latest&color=f58142)](https://feedz.io/org/xunit/repository/xunit/packages/xunit.analyzers)                     | [![](https://img.shields.io/endpoint.svg?url=https://actions-badge.atrox.dev/xunit/xunit.analyzers/badge%3Fref%3Dmain&amp;label=build)](https://actions-badge.atrox.dev/xunit/xunit.analyzers/goto?ref=main)
 | xunit.runner.visualstudio | [![](https://img.shields.io/nuget/v/xunit.runner.visualstudio.svg?logo=nuget)](https://www.nuget.org/packages/xunit.runner.visualstudio) | [![](https://img.shields.io/badge/endpoint.svg?url=https://f.feedz.io/xunit/xunit/shield/xunit.runner.visualstudio/latest&color=f58142)](https://feedz.io/org/xunit/repository/xunit/packages/xunit.runner.visualstudio) | [![](https://img.shields.io/endpoint.svg?url=https://actions-badge.atrox.dev/xunit/visualstudio.xunit/badge%3Fref%3Dmain&amp;label=build)](https://actions-badge.atrox.dev/xunit/visualstudio.xunit/goto?ref=main)
+
+## Issues and Discussions
+
+* Issues in the core framework and analyzers should be reported in the [primary issue tracker](https://github.com/xunit/xunit/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)
+* Issues in `xunit.runner.visualstudio` should be reported in the [project issue tracker](https://github.com/xunit/visualstudio.xunit/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)
+* Discussions are hosted in the [primary discussion forums](https://github.com/xunit/xunit/discussions?discussions_q=is%3Aunanswered+is%3Aopen)

site/index.md

@@ -0,0 +1,162 @@
+{{!Licensed to the .NET Foundation under one or more agreements. The .NET Foundation licenses this file to you under the MIT license.}}
+{{!include(/^public/.*/)}}
+{{!include(favicon.ico)}}
+{{!include(logo.svg)}}
+<!DOCTYPE html>
+<html {{#_lang}}lang="{{_lang}}"{{/_lang}}>
+  <head>
+    <meta charset="utf-8">
+    {{#redirect_url}}
+      <meta http-equiv="refresh" content="0;URL='{{redirect_url}}'">
+    {{/redirect_url}}
+    {{^redirect_url}}
+      <title>{{#title}}{{title}}{{/title}}{{^title}}{{>partials/title}}{{/title}} {{#_appTitle}}| {{_appTitle}} {{/_appTitle}}</title>
+      <meta name="viewport" content="width=device-width, initial-scale=1.0">
+      <meta name="title" content="{{#title}}{{title}}{{/title}}{{^title}}{{>partials/title}}{{/title}} {{#_appTitle}}| {{_appTitle}} {{/_appTitle}}">
+      {{#_description}}<meta name="description" content="{{_description}}">{{/_description}}
+      {{#description}}<meta name="description" content="{{description}}">{{/description}}
+      <link rel="icon" href="{{_rel}}{{{_appFaviconPath}}}{{^_appFaviconPath}}favicon.ico{{/_appFaviconPath}}">
+      <link rel="stylesheet" href="{{_rel}}public/docfx.min.css">
+      <link rel="stylesheet" href="{{_rel}}public/main.css">
+      <meta name="docfx:navrel" content="{{_navRel}}">
+      <meta name="docfx:tocrel" content="{{_tocRel}}">
+      {{#_noindex}}<meta name="searchOption" content="noindex">{{/_noindex}}
+      {{#_enableSearch}}<meta name="docfx:rel" content="{{_rel}}">{{/_enableSearch}}
+      {{#_disableNewTab}}<meta name="docfx:disablenewtab" content="true">{{/_disableNewTab}}
+      {{#_disableTocFilter}}<meta name="docfx:disabletocfilter" content="true">{{/_disableTocFilter}}
+      {{#docurl}}<meta name="docfx:docurl" content="{{docurl}}">{{/docurl}}
+      <meta name="loc:inThisArticle" content="{{__global.inThisArticle}}">
+      <meta name="loc:searchResultsCount" content="{{__global.searchResultsCount}}">
+      <meta name="loc:searchNoResults" content="{{__global.searchNoResults}}">
+      <meta name="loc:tocFilter" content="{{__global.tocFilter}}">
+      <meta name="loc:nextArticle" content="{{__global.nextArticle}}">
+      <meta name="loc:prevArticle" content="{{__global.prevArticle}}">
+      <meta name="loc:themeLight" content="{{__global.themeLight}}">
+      <meta name="loc:themeDark" content="{{__global.themeDark}}">
+      <meta name="loc:themeAuto" content="{{__global.themeAuto}}">
+      <meta name="loc:changeTheme" content="{{__global.changeTheme}}">
+      <meta name="loc:copy" content="{{__global.copy}}">
+      <meta name="loc:downloadPdf" content="{{__global.downloadPdf}}">
+
+      <script type="module" src="./{{_rel}}public/docfx.min.js"></script>
+
+      <script>
+        const theme = localStorage.getItem('theme') || 'auto'
+        document.documentElement.setAttribute('data-bs-theme', theme === 'auto' ? (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light') : theme)
+      </script>
+
+      {{#_googleAnalyticsTagId}}
+      <script async src="https://www.googletagmanager.com/gtag/js?id={{_googleAnalyticsTagId}}"></script>
+      <script>
+        window.dataLayer = window.dataLayer || [];
+        function gtag() { dataLayer.push(arguments); }
+        gtag('js', new Date());
+        gtag('config', '{{_googleAnalyticsTagId}}');
+      </script>
+      {{/_googleAnalyticsTagId}}
+    {{/redirect_url}}
+  </head>
+
+  {{^redirect_url}}
+  <body class="tex2jax_ignore" data-layout="{{_layout}}{{layout}}" data-yaml-mime="{{yamlmime}}">
+    <header class="bg-body border-bottom">
+      <nav id="autocollapse" class="navbar navbar-expand-md" role="navigation">
+        <div class="container-xxl flex-nowrap">
+          <a class="navbar-brand" href="{{_appLogoUrl}}{{^_appLogoUrl}}{{_rel}}index.html{{/_appLogoUrl}}">
+            <img id="logo" class="svg" src="{{_rel}}{{{_appLogoPath}}}{{^_appLogoPath}}logo.svg{{/_appLogoPath}}" alt="{{_appName}}" >
+            {{_appName}}
+          </a>
+          <form class="search" role="search" id="search">
+            <input class="form-control" id="search-query" type="search" disabled placeholder="{{__global.search}}" autocomplete="off" aria-label="Search">
+          </form>
+        </div>
+      </nav>
+    </header>
+
+    <main class="container-xxl">
+      {{^_disableToc}}
+      <div class="toc-offcanvas">
+        <div class="offcanvas-md offcanvas-start" tabindex="-1" id="tocOffcanvas" aria-labelledby="tocOffcanvasLabel">
+          <div class="offcanvas-header">
+            <h5 class="offcanvas-title" id="tocOffcanvasLabel">Table of Contents</h5>
+            <button type="button" class="btn-close" data-bs-dismiss="offcanvas" data-bs-target="#tocOffcanvas" aria-label="Close"></button>
+          </div>
+          <div class="offcanvas-body">
+            <nav class="toc" id="toc"></nav>
+          </div>
+        </div>
+      </div>
+      {{/_disableToc}}
+
+      <div class="content">
+        <div class="actionbar">
+          {{^_disableToc}}
+          <button class="btn btn-lg border-0 d-md-none"
+              type="button" data-bs-toggle="offcanvas" data-bs-target="#tocOffcanvas"
+              aria-controls="tocOffcanvas" aria-expanded="false" aria-label="Show table of contents">
+            <i class="bi bi-list"></i>
+          </button>
+          {{/_disableToc}}
+
+          {{^_disableBreadcrumb}}
+          <nav id="breadcrumb"></nav>
+          {{/_disableBreadcrumb}}
+        </div>
+
+        <article data-uid="{{uid}}">
+          {{#analyzer}}
+          <div>
+            <div style="font-size: 150%; float: right;">
+              &nbsp;
+              <span class="label label-version-{{ v2 }}">v2</span>
+              <span class="label label-version-{{ v3 }}">v3</span>
+              &nbsp;
+              <span class="label label-{{ severity }}">{{ severity }}</span>
+            </div>
+            <h1>{{ title }}</h1>
+          </div>
+
+          <p><em>&quot;{{description}}&quot;</em><p>
+          {{/analyzer}}
+
+          {{!body}}
+        </article>
+
+        {{^_disableContribution}}
+        <div class="contribution d-print-none">
+          {{#sourceurl}}
+          <a href="{{sourceurl}}" class="edit-link">{{__global.improveThisDoc}}</a>
+          {{/sourceurl}}
+          {{^sourceurl}}{{#docurl}}
+          <a href="{{docurl}}" class="edit-link">{{__global.improveThisDoc}}</a>
+          {{/docurl}}{{/sourceurl}}
+        </div>
+        {{/_disableContribution}}
+
+        {{^_disableNextArticle}}
+        <div class="next-article d-print-none border-top" id="nextArticle"></div>
+        {{/_disableNextArticle}}
+
+      </div>
+
+      {{^_disableAffix}}
+      <div class="affix">
+        <nav id="affix"></nav>
+      </div>
+      {{/_disableAffix}}
+    </main>
+
+    {{#_enableSearch}}
+    <div class="container-xxl search-results" id="search-results"></div>
+    {{/_enableSearch}}
+
+    <footer class="border-top text-secondary">
+      <div class="container-xxl">
+        <div class="flex-fill">
+          {{{_appFooter}}}{{^_appFooter}}<span>Made with <a href="https://dotnet.github.io/docfx">docfx</a></span>{{/_appFooter}}
+        </div>
+      </div>
+    </footer>
+  </body>
+  {{/redirect_url}}
+</html>