# Tutorials

## 🟦 For Non-Technical Users: No coding required! 🟦

These tutorials are written for everyone. You don’t need to know how to code. Just follow the steps and diagrams to get started quickly.

---

Welcome! These step-by-step guides will help you get started with Elvis, even if you have no technical background.

## Contents

- [Getting Started: Your First Call List](#getting-started-your-first-call-list)
- [Customizing Configuration](#customizing-configuration)
- [Running Elvis with History Append](#running-elvis-with-history-append)
- [Validating Output](#validating-output)

---

## Getting Started: Your First Call List

This tutorial walks you through installing Elvis and generating your first sales call list.

### Steps

1. **Download Elvis**
   - Go to the [main README](../elvis/README.md) and follow the install instructions.
2. **Run Elvis**
   - Open a terminal and run:

   ```sh
   bin/elvis.sh
   ```

3. **Check the Output**
   - Find your call list at `home/calllist.txt`.

#### Pseudocode

```pseudocode
Procedure GenerateCallList()
  Begin
    Download Elvis
    Run elvis.sh
    Output is written to home/calllist.txt
  End Procedure
```

---

## Customizing Configuration

You can change how Elvis works by editing `etc/elvisrc`. See the [Configuration Reference](Reference.md#configuration) for details.

---

## Running Elvis with History Append

To keep a record of all companies found, run:

```sh
bin/elvis.sh --append-history
```

This updates `srv/company_history.txt` and writes a patch to `var/spool/`.

---

## Validating Output

To check your call list for errors, run:

```sh
sh lib/validate_calllist.sh
```

See [How-to Guides](How-to-Guides.md#how-to-validate-output) for troubleshooting tips.

---

[Back to Wiki Home](Home.md)