* Pour le fran??ais, voir [README.fr.md](doc/README.fr.md)

### Specific Software Configuration

See the [installation guide](doc/install.md) to learn more about how to manage

your configuration and install your first managed home. You will learn that you

need a configuration file, usually `/data/alice/.config/guix/home.scm`. The rest

of this file is a set of links to specific and generic configuration functions

that you can add to that file. Whenever you see a procedure whose name ends

with "-home", you know that you can use it in the list of configurations, like

this:

```scheme

(home "/data/alice"

  (list (something-home ...)

        (something-else-home ...)

        (other-stuff-home ...)

        (yet-another-config-home ...)

        ...))

```

#### Desktop and Window Managers

* [Openbox](doc/openbox.md)

#### Communication Software

* [Hexchat](doc/hexchat.md)

### Common Issues

#### No Sound on the System

This is an issue with pulseaudio. Pulesaudio will never want to start when your

home directory is read-only, even though all its configuration files and

the files it will want to create are available read-write. To work around this,

it is advised to run pulseaudio from the command line in this way:

```bash

HOME=/tmp/pa `guix build pulseaudio`/bin/pulseaudio --start

```

Unfortunately, that means you cannot configure pulseaudio through Guix. You can

also add a similar line to your desktop or window manager's configuration to

instruct it to start pulseaudio. However, pulseaudio sometimes crashes for non

obvious reasons, and no graphical program will be able to restart it automatically

with a proper configuration.