Make the docs landing page more friendly (include simple template example)

I’m new to copier, but it looks this sentence in docs may need correction:

If a YAML file named copier.yml is found in the root of the project (alternatively, a YAML file named copier.yaml), the user will be prompted to fill in or confirm the default values.

https://copier.readthedocs.io/en/stable/creating/

Also substituting values seems a part of core logic of copier, yet there is nothing about it on the front page of the docs. You provide for copying examples (like shutil.copy), but the user like myself is more interested how to provide custom values for package name, author etc. It would be great if starting examples helped with that.

[epogrebnyak]

Maybe something with a folder tree, and one file using Jjinja templating.

My idea of what people look at on the first page: oh, it is a coockiecutter alternative? Is it easy to use? How can I mark the template? How can I provide the values to fill? Are there any special behaviours?

Similar page: https://cookiecutter.readthedocs.io/en/1.7.2/first_steps.html#your-first-cookiecutter

[pawamoy]

I just looked at the copier tag/topic on GitHub, and I wonder if copier-template would not be better, because there are quite a number of unrelated projects using the copier tag. I’m already using both of them in my templates, as well as copier-extension for my Copier+Jinja extension.

EDIT: my bad, the README already suggests using copier-template 🙂