Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
61 lines (37 loc) · 3.18 KB

CONTRIBUTING.md

File metadata and controls

61 lines (37 loc) · 3.18 KB
Raw

Contributing to WPF Framework

Thank you for your interest in contributing to WPF Framework! We welcome bug reports, feature requests, and other feedback from the community.

Review Capacity

WPF Framework is maintained by a small team within the U.S. Army Corps of Engineers Risk Management Center (USACE-RMC). Our capacity to review external pull requests is very limited. We prioritize issues and bug reports, which are always welcome and will be reviewed as resources permit.

If you plan to submit a pull request, please open an issue first to discuss your proposed change. This helps avoid duplicated effort and ensures your contribution aligns with the project's direction.

How to Contribute

Report a Bug

If you find a bug, please open a bug report and include:

  • What happened and what you expected instead
  • Steps to reproduce the problem, if you know them
  • The affected area or control, if you know it
  • Software version and operating system details, if available
  • Any relevant error messages, screenshots, logs, or sample files

Request a Feature

Feature requests are welcome. Please open a feature request describing:

  • The use case or problem you are trying to solve
  • What you would like the software or documentation to do
  • How important the request is to your work
  • Any current workaround, examples, screenshots, or files

Submit a Pull Request

Pull requests may take several weeks or longer to review. Before submitting code:

  1. Open an issue first to discuss the proposed change
  2. Follow the coding standards, including XML documentation on all public types and members
  3. Include unit tests that validate the new behavior
  4. Use xunit as the testing framework
  5. Ensure a clean build with zero errors and zero warnings
  6. Test with all three themes (Light, Dark, Blue) to verify visual correctness

Developer Certificate of Origin

By submitting a pull request, you certify under the Developer Certificate of Origin (DCO) Version 1.1 that you have the right to submit the work under the license associated with this project and that you agree to the DCO.

All contributions will be released under the same license as the project (see LICENSE).

Federal Government Contributors

U.S. Federal law prevents the government from accepting gratuitous services unless certain conditions are met. By submitting a pull request, you acknowledge that your services are offered without expectation of payment and that you expressly waive any future pay claims against the U.S. Federal government related to your contribution.

If you are a U.S. Federal government employee and use a *.mil or *.gov email address, your contribution is understood to have been created in whole or in part as part of your official duties and is not subject to domestic copyright protection under 17 USC 105.

Security

If you discover a security vulnerability, please do not open a public issue. Instead, contact the RMC team directly through official USACE-RMC channels.

License

See LICENSE for details. This software is provided under the Zero-Clause BSD (0BSD) license.