Standardize website content layout

This commit is contained in:
Przemysław Kłys
2026-04-11 10:13:28 +02:00
parent 043ce35deb
commit e8205302e3
5 changed files with 20 additions and 1 deletions
+19
View File
@@ -0,0 +1,19 @@
# GPOZaurr Website Content
This folder contains curated source content that the Evotec website imports for the GPOZaurr project page.
## Layout
- `content/project-docs/` contains short project documentation pages shown under `/projects/gpozaurr/docs/`.
- `content/examples/` contains curated website examples shown under `/projects/gpozaurr/examples/`.
- `WebsiteArtifacts/` is generated by `Build/Export-WebsiteArtifacts.ps1` at the repository root and is intentionally ignored by Git.
## Editing Rules
- Keep this folder intentional and small.
- Do not mirror the raw `Examples/` folder into the public website.
- Add only examples that have a clear explanation, a small code sample, and a link back to the original source file.
- Keep links rooted at `/projects/gpozaurr/` so the same content works on localhost, `evotec.xyz`, and `evotec.pl`.
- Run `Build/Export-WebsiteArtifacts.ps1` when API artifacts need to be refreshed.
The website pipeline prefers this `Website/content/...` layout over legacy root-level content folders.
+22
View File
@@ -0,0 +1,22 @@
---
title: "GPOZaurr Examples"
description: "Curated examples for common Group Policy administration and cleanup workflows."
layout: docs
---
These examples are maintained with the GPOZaurr repository and chosen for the website because they explain a real administrative workflow.
## Featured examples
<div class="ev-example-card-grid">
<a class="ev-example-card" href="./backup-disabled-or-empty-gpos/">
<span class="ev-example-card__eyebrow">Safe cleanup</span>
<h3>Back up disabled or empty GPOs</h3>
<p>Create a focused backup set before removing stale Group Policy Objects.</p>
</a>
<a class="ev-example-card" href="./find-group-policy-permission-issues/">
<span class="ev-example-card__eyebrow">Permission review</span>
<h3>Find Group Policy permission issues</h3>
<p>List permission problems that should be reviewed before remediation work starts.</p>
</a>
</div>
@@ -0,0 +1,43 @@
---
title: "Back up disabled or empty GPOs"
description: "Back up selected Group Policy Objects and verify the resulting backup set."
layout: docs
---
This example shows a practical starting point for cleaning up or reviewing older Group Policy environments before deeper remediation work.
It comes from the source example at `Examples/Example-01-BackupGPOs.ps1`.
## When to use this pattern
- You want to back up stale or disabled GPOs before any cleanup work.
- You need a quick inventory of what was actually exported.
- You want a repeatable backup step before broader Group Policy review.
## Example
```powershell
Import-Module "$PSScriptRoot\..\GPoZaurr.psd1" -Force
$GPOSummary = Backup-GPOZaurr `
-BackupPath "$Env:UserProfile\Desktop\GPO" `
-Verbose `
-Type Disabled, Empty `
-IncludeDomains 'ad.evotec.pl'
$GPOSummary | Format-Table -AutoSize
if ($GPOSummary) {
Get-GPOZaurrBackupInformation -BackupFolder $GPOSummary[0].BackupDirectory | Format-Table -AutoSize
}
```
## What this demonstrates
- targeted GPO backup instead of exporting everything blindly
- focusing on disabled or empty policies first
- validating the produced backup set after the export
## Source
- [Example-01-BackupGPOs.ps1](https://github.com/EvotecIT/GPOZaurr/blob/master/Examples/Example-01-BackupGPOs.ps1)
@@ -0,0 +1,34 @@
---
title: "Find Group Policy permission issues"
description: "Use GPOZaurr to list permission problems that should be reviewed before cleanup or remediation."
layout: docs
---
This example is a practical first pass for environments where Group Policy permissions have changed over time and nobody is fully sure what still matches the intended model.
It comes from the source example at `Examples/Example-08-ListingPermissionIssues.ps1`.
## When to use this pattern
- You want to identify GPO permission problems before making changes.
- You need evidence for a cleanup or remediation plan.
- You want a small, repeatable report that can be reviewed by the directory operations team.
## Example
```powershell
Import-Module "$PSScriptRoot\..\GPoZaurr.psd1" -Force
$Issues = Get-GPOZaurrPermissionIssue
$Issues | Format-Table -AutoSize
```
## What this demonstrates
- separating discovery from remediation
- getting a reviewable list of permission issues
- creating a safer starting point for Group Policy cleanup
## Source
- [Example-08-ListingPermissionIssues.ps1](https://github.com/EvotecIT/GPOZaurr/blob/master/Examples/Example-08-ListingPermissionIssues.ps1)