# Contributing

## Bug reports

If you find any bugs, we gladly accept pull requests without prior discussion.
Otherwise, you can of course always open an issue for us to look into.

## Feature requests

Please open a new issue for any feature requests you have in mind.
Since most of the behavior comes from upstream (`deps/`), new features are usually best discussed (and landed) upstream first.

## Code changes

This repository is a Microsoft-maintained Windows build of upstream coreutils.
The bulk of the implementation lives in `deps/`:

* `deps/coreutils`: fork of [uutils/coreutils](https://github.com/uutils/coreutils),
  the Rust reimplementation of GNU coreutils, with Windows-patches pending upstreaming.
* `deps/findutils`: [uutils/findutils](https://github.com/uutils/findutils),
  providing `find` and `xargs`.
* `deps/grep`: fork of [uutils/grep](https://github.com/uutils/grep),
  providing `grep`, `egrep`, and `fgrep`.

When changing a utility's behavior, prefer landing the change in the relevant
upstream project first and then updating the submodule here. Windows-specific
glue, packaging, and the multi-call binary wrapper live in this repo and are
fair game for direct PRs.