# User guide

Short, actionable guides that cover specific topics with `repo2docker`.
Select from the pages listed below to get started.

Information about configuring your repository to work with `repo2docker`,
and controlling elements of the built environment using configuration files.

```{toctree}
:caption: Image building basics
:maxdepth: 1
pathways
../configuration/index
repository
../cli
```

```{toctree}
:maxdepth: 1
:caption: Customize your environment

../howto/user_interface
../howto/languages
../howto/lab_workspaces
./actions-and-scripts
../howto/export_environment
../howto/base_image
```

```{toctree}
:maxdepth: 1
:caption: Deploy images into production

../howto/deploy
./community-image
./extend-community-image
../howto/jupyterhub_images
./action
../howto/breaking_changes
```

```{toctree}
:maxdepth: 2
:caption: Learn about repo2docker

../faq
../specification
```