Docs updates

@zoni This should be right up your alley.
Trouble with an empty dict is we can't easily test it.

```python
if configuration is not None:
  do stuff
elif not configuration:
  reset
else
  use normal template
```

Now we'll never get into the `else` branch. The only way I see around that is explicitly doing `elif len(configuration) == 0` but that's horribly unpythonic.

Possible other option would be to go:

```
if configuration == 'reset':
  use template
elif configuration is not None:
  do the magic
else
  template
```

I don't really like this either.

Do you have a suggestion?