Skip to content

Commit e052f79

Browse files
committed
add getting started parameter and fix refer to the correct contribution guidelines
1 parent 633198f commit e052f79

File tree

4 files changed

+12
-16
lines changed

4 files changed

+12
-16
lines changed

copier.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,10 @@ project_long_description:
77
help: "A long description of the project"
88
default: ""
99

10+
project_getting_started:
11+
type: str
12+
help: "A short description of how to get started with the project"
13+
1014
git_username:
1115
type: str
1216
help: "The GitHub username or organization name"

template/README.md.jinja

Lines changed: 5 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -7,23 +7,13 @@
77
[![CircleCI](https://circleci.com/gh/{{ git_username }}/{{ project_slug | replace("_", "-") }}.svg?style=shield)](https://circleci.com/gh/{{ git_username }}/{{ project_slug | replace("_", "-") }})
88
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/pyfar/gallery/main?labpath=docs/gallery/interactive/pyfar_introduction.ipynb)
99

10-
1110
{{ project_long_description }}
1211

13-
Getting Started
14-
===============
12+
## Getting Started
1513

16-
The [pyfar workshop](https://mybinder.org/v2/gh/pyfar/gallery/main?labpath=docs/gallery/interactive/pyfar_introduction.ipynb)
17-
gives an overview of the most important pyfar functionality and is a good
18-
starting point. It is part of the [pyfar example gallery](https://pyfar-gallery.readthedocs.io/en/latest/examples_gallery.html)
19-
that also contains more specific and in-depth
20-
examples that can be executed interactively without a local installation by
21-
clicking the mybinder.org button on the respective example. The
22-
[pyfar documentation](https://pyfar.readthedocs.io) gives a detailed and complete overview of pyfar. All
23-
these information are available from [pyfar.org](https://pyfar.org).
14+
{{ project_getting_started }}
2415

25-
Installation
26-
============
16+
## Installation
2717

2818
Use pip to install {{ project_slug }}
2919

@@ -33,7 +23,6 @@ Use pip to install {{ project_slug }}
3323

3424
If the installation fails, please check out the [help section](https://pyfar-gallery.readthedocs.io/en/latest/help).
3525

36-
Contributing
37-
============
26+
## Contributing
3827

39-
Check out the [contributing guidelines](https://pyfar.readthedocs.io/en/stable/contributing.html) if you want to become part of pyfar.
28+
Check out the [contributing guidelines](https://{{ project_slug }}.readthedocs.io/en/stable/contributing.html) if you want to become part of pyfar.

tests/conftest.py

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ def copier_project_defaults():
55
return {
66
"project_slug": "my_project",
77
"project_long_description": "my_project_description",
8+
"project_getting_started": "This is how to get started with my_project.",
89
"git_username": "pyfar",
910
"minimum_python_version": "3.11",
1011
}

tests/test_copier.py

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,8 @@ def test_generated_file_exists(copie, copier_project_defaults, file_name):
2626
"main/docs/resources/logos/pyfar_logos_fixed_size_my_project.png",
2727
"Python 3.11 or higher",
2828
"py/my_project.svg",
29+
"https://my_project.readthedocs.io/en/stable/contributing.html",
30+
"\nThis is how to get started with my_project.\n",
2931
])
3032
def test_content_readme(copie, copier_project_defaults, desired):
3133
project = copie.copy(extra_answers=copier_project_defaults)

0 commit comments

Comments
 (0)