Skip to content

Commit 50d6dd7

Browse files
authored
Merge pull request #623 from NLeSC/575-user-profiles
575-user-profiles
2 parents caf8c92 + 076aaac commit 50d6dd7

2 files changed

Lines changed: 22 additions & 3 deletions

File tree

CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@
1717
* Make online documentation optional [#476](https://github.com/NLeSC/python-template/pull/476)
1818

1919
### Changed
20+
* Update the user documentation (README.md) of the template [#575](https://github.com/NLeSC/python-template/pull/623)
2021
* Updated .gitignore [#622](https://github.com/NLeSC/python-template/pull/622)
2122
* add extra info for sub-menus [#628](https://github.com/NLeSC/python-template/pull/628)
2223
* skip merging CHANGELOG.md and CODE_OF_CONDUCT.md if they exist [#628](https://github.com/NLeSC/python-template/pull/628)

README.md

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,26 @@
11
# Netherlands eScience Center Python Template
22

3-
Spend less time setting up and configuring your new Python packages which includes research software good practices from the start.
3+
Spend less time setting up and configuring your new Python packages by using this template. This [Copier](https://copier.readthedocs.io) template includes best practices for research software so your new package will include these practices from the start.
44

5-
Use this [Copier](https://copier.readthedocs.io) template to generate an empty Python package. Features include:
5+
You can choose from various user profiles, each offering a range of features to suit your needs.
6+
7+
## User profiles
8+
9+
The template profiles for a Python package offer varying levels of customization to cater to different user needs. Below are the profiles the template offers.
10+
11+
### Minimum
12+
13+
This profile offers the essential features to begin developing a Python package, making it ideal for first-time research software developers. Additional features can be added as needed.
14+
15+
### Recommended
16+
17+
This option provides a pre-selected set of features for research software, which users can fully customize.
18+
19+
### Let me choose
20+
21+
This fully customizable profile enables you to selectively include or exclude features in your Python package.
22+
23+
## Features
624

725
- Boilerplate unit tests and documentation,
826
- [Python static setup configuration](template/pyproject.toml.jinja),
@@ -14,7 +32,7 @@ Use this [Copier](https://copier.readthedocs.io) template to generate an empty P
1432
- [README.md](template/README.md.jinja) for package users,
1533
- [README.dev.md](template/README.dev.md.jinja) for package developer,
1634
- [project_setup.md](template/project_setup.md.jinja) with extensive documentation about project setup,
17-
- [Change log](template/%7B%25%20if%20AddChangeLog%20%25%7DCHANGELOG.md%7B%25%20endif%20%25%7D),
35+
- [Changelog](template/%7B%25%20if%20AddChangeLog%20%25%7DCHANGELOG.md%7B%25%20endif%20%25%7D),
1836
- [Code of Conduct](template/CODE_OF_CONDUCT.md.jinja),
1937
- [Contributing guidelines](template/CONTRIBUTING.md.jinja),
2038
- Continuous code quality and code coverage reporting using [Sonarcloud](https://sonarcloud.io/),

0 commit comments

Comments
 (0)