# Conventions

The following conventions are used throughout the installation material.

## Angle brackets ( < and > )

Phrases wrapped in angle brackets (i.e., `<`, `>`) are placeholders used to indicate values that must be substituted with user-provided values. Placeholders are typically written in either [kebab case](https://developer.mozilla.org/en-US/docs/Glossary/Kebab_case), or [snake case](https://developer.mozilla.org/en-US/docs/Glossary/Snake_case); the following placeholders are equivalent:

* `<the-quick-brown-fox>`
* `<the_quick_brown_fox>`

### Example

#### Input

```yaml
computerScientists:
- Alan Turing
- Grace Hopper
- Donald Knuth
- Tim Berners-Lee
- John McCarthy
- <first-name> <last-name>
```

#### Output

```yaml
computerScientists:
- Alan Turing
- Grace Hopper
- Donald Knuth
- Tim Berners-Lee
- John McCarthy
- Margaret Hamilton
```