Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions .github/PR_PREFERENCES.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Pull Request Preferences

This repository prefers plain Git for local operations and the GitHub web UI for
creating pull requests. This note documents that preference so contributors and
automation respect the chosen workflow.

Recommendations
Copy link

Copilot AI Nov 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The section headings "Recommendations" and "Why this preference" should be formatted as proper Markdown headings (using ##) instead of plain text. This improves document structure and navigation.

Copilot uses AI. Check for mistakes.

- Use git to create branches, stage, commit, and push. Example:

```powershell
# create branch, stage, commit and push
git checkout -b fix/my-change
git add <files>
git commit -m "Describe change"
git push -u origin fix/my-change
```

- Create the pull request using the GitHub web UI by visiting the branch URL.

Example (replace placeholders with actual values):

- `https://github.com/OWNER/REPO/pull/new/BRANCH`

For this repository the shortcut after pushing a branch is:

- `https://github.com/AprilDeFeu/Scripts/pull/new/BRANCH`

- Avoid using the GitHub CLI (`gh`) in automation for this repo. If you want to
use `gh` in your local environment, that is fine — but do not rely on CI or
repository-side automation that requires `gh` to be present.

- If you integrate other tools (for example GitKraken or GitHub Apps), only do
so after confirming credentials and access are explicitly authorized.

Why this preference
Copy link

Copilot AI Nov 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The section heading "Why this preference" should be formatted as a proper Markdown heading (using ##) instead of plain text. This improves document structure and navigation.

Suggested change
Why this preference
## Why this preference

Copilot uses AI. Check for mistakes.

- Plain `git` is universally available and works in CI and local shells without
adding additional tooling requirements.
- The web UI provides a clear, auditable PR creation step for maintainers.

If you'd like this document adjusted (formatting, wording, or to include a
specific workflow your team prefers), please open a PR against the main
branch.
27 changes: 27 additions & 0 deletions PowerShell/system-administration/maintenance/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# PowerShell — system-administration/maintenance

This folder contains PowerShell scripts focused on system maintenance tasks.

Typical responsibilities include package cleanup, service health checks,
temporary-file housekeeping, and other routine maintenance utilities.

Usage and placement

- Place small, single-purpose maintenance scripts here.
- For complex tools with multiple files, include a top-level README and a
subfolder with implementation files.

Naming and contribution
Copy link

Copilot AI Nov 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The section heading "Naming and contribution" should be formatted as a proper Markdown heading (using ##) instead of plain text. This improves document structure and navigation.

Suggested change
Naming and contribution
## Naming and contribution

Copilot uses AI. Check for mistakes.

- Use descriptive kebab-case names, e.g. `clean-temp-folders.ps1` or
`check-service-health.ps1`.
- Add header documentation (comment-based help) and examples for each script.
- Include `-WhatIf` support for potentially destructive operations.

Examples
Comment on lines +8 to +21
Copy link

Copilot AI Nov 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The section headings "Usage and placement", "Naming and contribution", and "Examples" should be formatted as proper Markdown headings (using ##) instead of plain text. This improves document structure and navigation.

Suggested change
Usage and placement
- Place small, single-purpose maintenance scripts here.
- For complex tools with multiple files, include a top-level README and a
subfolder with implementation files.
Naming and contribution
- Use descriptive kebab-case names, e.g. `clean-temp-folders.ps1` or
`check-service-health.ps1`.
- Add header documentation (comment-based help) and examples for each script.
- Include `-WhatIf` support for potentially destructive operations.
Examples
## Usage and placement
- Place small, single-purpose maintenance scripts here.
- For complex tools with multiple files, include a top-level README and a
subfolder with implementation files.
## Naming and contribution
- Use descriptive kebab-case names, e.g. `clean-temp-folders.ps1` or
`check-service-health.ps1`.
- Add header documentation (comment-based help) and examples for each script.
- Include `-WhatIf` support for potentially destructive operations.
## Examples

Copilot uses AI. Check for mistakes.
Copy link

Copilot AI Nov 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The section heading "Examples" should be formatted as a proper Markdown heading (using ##) instead of plain text. This improves document structure and navigation.

Suggested change
Examples
## Examples

Copilot uses AI. Check for mistakes.

- `clean-temp-folders.ps1` — remove old files from temporary directories
- `rotate-logs.ps1` — rotate and compress rotating logs
Copy link

Copilot AI Nov 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo in comment: "rotating logs" should be "log files" for clarity. The phrase "rotate and compress rotating logs" is redundant.

Suggested change
- `rotate-logs.ps1` — rotate and compress rotating logs
- `rotate-logs.ps1` — rotate and compress log files

Copilot uses AI. Check for mistakes.

Thank you for contributing maintenance scripts — please follow the
repository's contribution guidelines in the main `CONTRIBUTING.md`.