docs: clarify run.yaml files are starting points for customization

- Add new documentation section on customizing run.yaml files
- Clarify that generated run.yaml files are templates, not production configs
- Add guidance on customization best practices and common scenarios
- Update existing documentation to reference customization guide
- Improve clarity around run.yaml file usage for better user experience

This enhancement makes it clearer for users that run.yaml files are meant
to be customized for production use, improving the overall developer experience.
This commit is contained in:
skamenan7 2025-07-14 11:22:15 -04:00
parent 618ccea090
commit 9613c63ca6
5 changed files with 50 additions and 1 deletions

View file

@ -145,6 +145,10 @@ $ llama stack build --template starter
...
You can now edit ~/.llama/distributions/llamastack-starter/starter-run.yaml and run `llama stack run ~/.llama/distributions/llamastack-starter/starter-run.yaml`
```
```{tip}
The generated `run.yaml` file is a starting point for your configuration. For comprehensive guidance on customizing it for your specific needs, infrastructure, and deployment scenarios, see [Customizing Your run.yaml Configuration](customizing_run_yaml.md).
```
:::
:::{tab-item} Building from Scratch