Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
44 lines (33 loc) · 1.41 KB

CONTRIBUTING.md

File metadata and controls

44 lines (33 loc) · 1.41 KB

Contributing to MiniTaskbar

Thank you for taking the time to improve MiniTaskbar. The project values predictable Windows 10 behavior, low resource usage, and changes that remain easy to audit.

Before You Start

  1. Search for an existing issue before creating a new one.
  2. Open an issue first when proposing a significant behavior change.
  3. Keep changes focused. Avoid unrelated refactors.

Local Environment

MiniTaskbar builds on 64-bit Windows with .NET Framework 4.x:

git clone https://github.com/Mirochill/MiniTaskbar.git
cd MiniTaskbar
.\build.ps1
.\test.ps1

Contribution Guidelines

  • Preserve the intentionally small Windows 10 feature set.
  • Do not add telemetry, implicit network communication, or background services.
  • Avoid third-party dependencies when a Windows or .NET Framework API is sufficient.
  • Add or update tests when behavior changes.
  • Run .\build.ps1 and .\test.ps1 before opening a pull request.
  • Measure the impact of changes to resident paths, especially event handling, fullscreen transitions, and Explorer restart recovery.
  • Document any added reliance on undocumented Windows behavior.

Pull Requests

Describe the problem, the selected approach, and the checks you ran. Include before-and-after screenshots when intentionally modifying the taskbar appearance.

By submitting a contribution, you agree that it will be distributed under the project's MIT License.