docs: Product docs rework for new release (#8332)

Author: yufeih

.gitignore

@@ -1,37 +1,20 @@
-packages
 bin
-csx
 obj
-xdocoutput
+drop
+temp
 node_modules
-*.sln.ide
-TestResults
-TestTools
 .vs
 .vscode
-.NuGet
-artifacts
-target
 _site
 _site_pdf
+docs/api
 
-*.nupkg
 *.log
-*.tmp
-*.vsprops
-*.suo
-*.user
-*.userprefs
-*.sdf
-*.sln.ide
 *.cache
-*.sln.metaproj
 .settings
 .DS_Store
-log.txt
-debugSettings.json
 launchSettings.json
-project.lock.json
 package-lock.json
 *.sublime-workspace
 *.nuget.targets
+*.code-workspace

.vsconfig

@@ -4,32 +4,17 @@
     "Microsoft.VisualStudio.Component.CoreEditor",
     "Microsoft.VisualStudio.Workload.CoreEditor",
     "Microsoft.VisualStudio.Component.NuGet",
-    "Microsoft.Net.Component.4.6.1.TargetingPack",
     "Microsoft.VisualStudio.Component.Roslyn.Compiler",
     "Microsoft.VisualStudio.Component.Roslyn.LanguageServices",
     "Microsoft.VisualStudio.Component.FSharp",
-    "Microsoft.Net.Core.Component.SDK.2.1",
-    "Microsoft.Net.Component.4.7.2.SDK",
-    "Microsoft.Net.Component.4.7.2.TargetingPack",
+    "Microsoft.NetCore.Component.SDK",
     "Microsoft.Net.ComponentGroup.DevelopmentPrerequisites",
     "Microsoft.Component.MSBuild",
-    "Microsoft.VisualStudio.Component.TextTemplating",
-    "Microsoft.VisualStudio.Component.SQL.CLR",
     "Microsoft.VisualStudio.Component.ManagedDesktop.Core",
-    "Microsoft.Net.Component.4.5.2.TargetingPack",
-    "Microsoft.Net.Component.4.5.TargetingPack",
-    "Microsoft.VisualStudio.Component.IntelliCode",
-    "Microsoft.Net.Component.4.TargetingPack",
-    "Microsoft.Net.Component.4.5.1.TargetingPack",
-    "Microsoft.Net.Component.4.6.TargetingPack",
     "Microsoft.Net.ComponentGroup.TargetingPacks.Common",
     "Microsoft.VisualStudio.Component.IntelliTrace.FrontEnd",
     "Microsoft.VisualStudio.Component.DiagnosticTools",
-    "Microsoft.VisualStudio.Component.EntityFramework",
-    "Microsoft.VisualStudio.Component.LiveUnitTesting",
-    "Component.Microsoft.VisualStudio.LiveShare",
     "Microsoft.VisualStudio.Component.ManagedDesktop.Prerequisites",
-    "Microsoft.ComponentGroup.Blend",
     "Microsoft.VisualStudio.Component.Debugger.JustInTime",
     "Microsoft.VisualStudio.Workload.ManagedDesktop"
   ]

README.md

@@ -12,16 +12,16 @@
 
 Build your technical documentation site with docfx, with landing pages, markdown, API reference docs for .NET, REST API and more.
 
-> ⚠️⚠️⚠️ NOTICE ⚠️⚠️⚠️:
+> ⚠️⚠️⚠️ NOTICE ⚠️⚠️⚠️
 >
 > For [Microsoft Learn](https://learn.microsoft.com/) users, the open source version of docfx [_will NOT_ be maintained to support Microsoft Learn content](https://github.com/dotnet/docfx/discussions/8277#discussioncomment-4409645). For Microsoft Learn feature requests, bug reports and other support ticks, use internal channels such as the [Learn Platform Support Channel](https://teams.microsoft.com/l/team/19%3a7ecffca1166a4a3986fed528cf0870ee%40thread.skype/conversations?groupId=de9ddba4-2574-4830-87ed-41668c07a1ca&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47).
 
 ## Getting Started
 
-1. Install docfx using [`choco`](https://chocolatey.org/):
+1. Install docfx as a global tool:
 
     ```bash
-    choco install docfx
+    dotnet tool install -g docfx
     ```
 
 2. Create and start a website locally:

RELEASENOTE.md

@@ -1,6 +1,8 @@
-Version Notes (Current Version: v2.59.5)
+Release Notes
 =======================================
 
+> NOTE: Starting from v2.30.0, release notes are published to [GitHub Releases](https://github.com/dotnet/docfx/releases).
+
 v2.59.5
 -----------
 1. Fix: TOC word-break not being inserted in generic types. Thanks @julesabr! (#8217)