Make changelog optional

Fixes #462

Author: sverhoeven

copier.yml

@@ -77,11 +77,15 @@ AddGitHubActions:
   default: "{{ template_profile != 'minimum' }}"
   help: GitHub actions to test the package and the documentation
 
+AddChangeLog:
+  when: "{{ template_profile == 'ask' }}"
+  type: bool
+  default: "{{ template_profile != 'minimum' }}"
+  help: Add a change log to keep track of changes in the package
 
 # internal fields
 _subdirectory: template
 
-
 # user messages
 _message_before_copy: |
     Thanks for generating a project using our template.

template/CONTRIBUTING.md.jinja

@@ -35,7 +35,9 @@ The sections below outline the steps in each case.
 1. make sure the existing tests still work by running ``pytest``;
 1. add your own tests (if necessary);
 1. update or expand the documentation;
+{% if AddChangeLog -%}
 1. update the `CHANGELOG.md` file with your change;
+{%- endif %}
 1. [push](http://rogerdudler.github.io/git-guide/) your feature branch to (your fork of) the {{ package_name }} repository on GitHub;
 1. create the pull request, e.g. following the instructions [here](https://help.github.com/articles/creating-a-pull-request/).
 
@@ -47,7 +49,9 @@ To create a release you need write permission on the repository.
 
 1. Check the author list in [`CITATION.cff`](CITATION.cff)
 1. Bump the version using `bump-my-version bump <major|minor|patch>`. For example, `bump-my-version bump major` will increase major version numbers everywhere it's needed (code, meta, etc.) in the repo. Alternatively the version can be manually changed in {{ package_name }}/__init__.py, pyproject.toml, CITATION.cff and docs/conf.py (and other places it was possibly added).
+{% if AddChangeLog -%}
 1. Update the `CHANGELOG.md` to include changes made
+{%- endif %}
 1. Go to the [GitHub release page]({{ repository_url }}/releases)
 1. Press draft a new release button
 1. Fill version, title and description field

template/README.dev.md.jinja

@@ -133,10 +133,12 @@ This section describes how to make a release in 3 parts:
 
 ### (1/3) Preparation
 
+{% if AddChangeLog -%}
 1. Update the <CHANGELOG.md> (don't forget to update links at bottom of page)
-2. Verify that the information in [`CITATION.cff`](CITATION.cff) is correct.
-3. Make sure the [version has been updated](#versioning).
-4. Run the unit tests with `pytest -v`
+{%- endif %}
+1. Verify that the information in [`CITATION.cff`](CITATION.cff) is correct.
+1. Make sure the [version has been updated](#versioning).
+1. Run the unit tests with `pytest -v`
 
 ### (2/3) PyPI
 

template/project_setup.md.jinja

@@ -85,10 +85,12 @@ help you decide which tool to use for packaging.
 - The project is set up with a logging example.
 - [Relevant section in the guide](https://guide.esciencecenter.nl/#/best_practices/language_guides/python?id=logging)
 
+{% if AddChangeLog -%}
 ## CHANGELOG.md
 
 - Document changes to your software package
 - [Relevant section in the guide](https://guide.esciencecenter.nl/#/best_practices/releases?id=changelogmd)
+{%- endif %}
 
 ## CITATION.cff
 

template/pyproject.toml.jinja

@@ -71,7 +71,9 @@ publishing = [
 [project.urls]
 Repository = "{{ repository_url }}"
 Issues = "{{ repository_url }}/issues"
+{% if AddChangeLog -%}
 Changelog = "{{ repository_url }}/CHANGELOG.md"
+{%- endif %}
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]