Initial page of CS8802 error (#43728)

* Create initial page of CS8802

* Link CS8803 and top-level statements to the page

* Correct the ms.date in CS8802 page metadata

Co-authored-by: Youssef Victor <[email protected]>

* Remove CS8802 from list of missing pages

* Remove solution from single compilation unit explanation

A solution can, for example, contain multiple console applications.

Co-authored-by: Bill Wagner <[email protected]>

---------

Co-authored-by: Youssef Victor <[email protected]>
Co-authored-by: Bill Wagner <[email protected]>

Author: 3 people

docs/csharp/language-reference/compiler-messages/cs8802.md

@@ -0,0 +1,49 @@
+---
+description: "Compiler Error CS8802"
+title: "Compiler Error CS8802"
+ms.date: 11/24/2024
+f1_keywords:
+  - "CS8802"
+helpviewer_keywords:
+  - "CS8802"
+---
+# Compiler Error CS8802
+
+Only one compilation unit can have top-level statements.
+
+This error indicates that there are two or more [top-level statements](../../fundamentals/program-structure/top-level-statements.md) in a single compilation unit (single project or a single group of files compiled into a single binary file).
+
+## Example
+
+The following sample of single compilation unit generates CS8802:
+
+```xml
+<!-- SingleCompilationUnit.csproj -->
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+  </PropertyGroup>
+</Project>
+```
+
+```csharp
+// EntryFile.cs
+
+int a = 0;
+```
+
+```csharp
+// SecondaryEntryFile.cs
+
+int b = 1;    // CS8802: The top level statement already exists in EntryFile.cs
+```
+
+## To correct this error
+
+Use only one top-level statement in the project.
+<br/>Top-level statements acts as an entry point to the program, so only one file may have top-level statement. All other statements must be defined as members of classes or structs.
+
+## See also
+
+- [Top-level statements](../../fundamentals/program-structure/top-level-statements.md)
+- [CS8803](./cs8803.md)

docs/csharp/misc/sorry-we-don-t-have-specifics-on-this-csharp-error.md

@@ -425,7 +425,6 @@ f1_keywords:
   - "CS8793"
   - "CS8794"
   - "CS8801"
-  - "CS8802"
   - "CS8804"
   - "CS8805"
   - "CS8806"