Add documentation

Author: Corniel

README.md

@@ -130,6 +130,8 @@ reported a the [GibHub repository](https://github.com/dotnet-project-file-analyz
 * [**Proj0805** Define version for PackageReference](rules/Proj0805.md)
 * [**Proj0806** VersionOverride should change the version](rules/Proj0806.md)
 * [**Proj0807** Use Directory.Packages.props only for Central Package Management](rules/Proj0807.md)
+* [**Proj0808** Define global package reference only in Directory.Packages.props](rules/Proj0808.md)
+* [**Proj0809** Global package references are meant for private assets only](rules/Proj0809.md)
 
 ### Analyzers
 * [**Proj1000** Use the .NET project file analyzers](rules/Proj1000.md)

rules/Proj0807.md

@@ -23,15 +23,11 @@ work otherwise, it is counter-intuitive and recipe for disaster.
 
   <ItemGroup>
     <PackageVersion Include="Qowaiv" Version="7.0.0" />
-    <PackageVersion Include="PolySharp" Version="1.14.1" />
+    <PackageVersion Include="DotNetProjectFile.Analyzers" Version="1.5.8" />
   </ItemGroup>
 
   <ItemGroup>
-    <GlobalPackageReference Include="System.Text.Json" Vesion="8.0.4" />
-  </ItemGroup>
-  
-  <ItemGroup>
-    <PackageReference Include="PolySharp" PrivateAssets="all" />
+    <PackageReference Include="DotNetProjectFile.Analyzers" PrivateAssets="all" />
   </ItemGroup>
 
   <ItemGroup>
@@ -40,7 +36,6 @@ work otherwise, it is counter-intuitive and recipe for disaster.
   </ItemGroup>
 
 </Project>
-
 ```
 
 ## Compliant
@@ -56,17 +51,15 @@ work otherwise, it is counter-intuitive and recipe for disaster.
 
   <ItemGroup>
     <PackageVersion Include="Qowaiv" Version="7.0.0" />
-    <PackageVersion Include="PolySharp" Version="1.14.1" />
   </ItemGroup>
-  
+    
   <ItemGroup>
-    <GlobalPackageReference Include="System.Text.Json" Vesion="8.0.4" />
+    <GlobalPackageReference Include="DotNetProjectFile.Analyzers" Vesion="1.5.8" />
   </ItemGroup>
 
   <ItemGroup>
     <AdditionalFiles Include="Directory.Packages.props" Link="Properties/Directory.Packages.props" />
   </ItemGroup>
 
 </Project>
-
 ```

rules/Proj0808.md

@@ -0,0 +1,27 @@
+---
+parent: Central Package Management
+ancestor: Rules
+---
+
+# Proj0808: Define global package reference only in Directory.Packages.props
+When using [Central Package Management](Proj0800.md) the central `Directory.Packages.props`
+it is possible to define package reference globally with the use of
+[`<GlobalPackageReference>`](https://learn.microsoft.com/en-us/nuget/consume-packages/central-package-management#global-package-references).
+This references should be in your `Directory.Packages.props` only.
+
+
+## Compliant
+If defined in `Directory.Packages.props`
+``` xml
+<Project>
+
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <GlobalPackageReference Include="DotNetProjectFile.Analyzers" Vesion="1.5.8" />
+  </ItemGroup>
+
+</Project>
+```

rules/Proj0809.md

@@ -0,0 +1,40 @@
+---
+parent: Central Package Management
+ancestor: Rules
+---
+
+# Proj0809: Global package references are meant for private assets only
+When using [Central Package Management](Proj0800.md) the central `Directory.Packages.props`
+it is possible to define package reference globally with the use of
+[`<GlobalPackageReference>`](https://learn.microsoft.com/en-us/nuget/consume-packages/central-package-management#global-package-references).
+This should only be used for references that should be handled as a private asset.
+
+## Non-compliant
+``` xml
+<Project>
+
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <GlobalPackageReference Include="Qowaiv" Vesion="7.0.0" />
+  </ItemGroup>
+
+</Project>
+```
+
+## Compliant
+``` xml
+<Project>
+
+  <PropertyGroup>
+    <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <GlobalPackageReference Include="DotNetProjectFile.Analyzers" Vesion="1.5.8" />
+  </ItemGroup>
+
+</Project>
+```