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
4 changes: 2 additions & 2 deletions .github/PR_PREFERENCES.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ 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
## Recommendations

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

Expand Down Expand Up @@ -33,7 +33,7 @@ git push -u origin fix/my-change
- 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
## Why this preference

- Plain `git` is universally available and works in CI and local shells without
adding additional tooling requirements.
Expand Down
8 changes: 4 additions & 4 deletions PowerShell/system-administration/maintenance/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,23 +5,23 @@ 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
## 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
## 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
## Examples

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

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