# Concrete usage example
This directory contains a full example of using the ECS tools to manage your
project's index template (or your Beats field definitions) with the ECS tools.
The `fields` directory contains files managed by the sample project, whereas
the `generated` directory contains the files generated by running the following
command from the root of the ECS repository:
```bash
python scripts/generator.py --ref v8.0.0 \
--subset usage-example/fields/subset.yml \
--include usage-example/fields/custom/ \
--out usage-example/ \
--template-settings-legacy usage-example/fields/template-settings-legacy.json \
--template-settings usage-example/fields/template-settings.json \
--mapping-settings usage-example/fields/mapping-settings.json
```
Refer back to [USAGE.md](../USAGE.md) for the documentation on each of these flags.