diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 000000000000..cd32e3c9120a --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,9 @@ +# Changelog +All notable changes to this project will be documented in this file. + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +## [Unreleased] +### Added +- CHANGELOG.md to document notable changes. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 4df021f3eeb1..eaade855e5d3 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -5,7 +5,7 @@ The following is a set of guidelines for contributing to edflow. These are mostl > ### code-block > In your docstring write **``.. code-block:: ``**, when showing examples. > -> This comment is right here, because everyone seems to do it wrong. +> This comment is right here, because everyone seems to be doing it wrong. #### Table Of Contents @@ -30,17 +30,17 @@ The following is a set of guidelines for contributing to edflow. These are mostl ## Code of Conduct -This project and everyone participating in it is governed by the [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to [pesser@github.com](mailto:pesser@github.com). +This project and everyone participating in it is governed by the [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to [patrick.esser@iwr.uni-heidelberg.de](mailto:patrick.esser@iwr.uni-heidelberg.de). ## I just have a question! -> **Note:** [Please don't file an issue to ask a question.] - -If you have any questions on how to use edflow, feel free to contact Mimo Tillbich. +If the [documentation](https://edflow.readthedocs.io/en/latest/) cannot help +you, feel free to contact one of the +[contributors](https://github.com/pesser/edflow#contributors). ## The Basics -Before you do anything, we advise you to read the [documentation](https://edflow.readthedocs.io/en/latest/), it's really not that long and helps a lot... +Before you do anything, we advise you to read the [documentation](https://edflow.readthedocs.io/en/latest/), it's really not that long and helps a lot. ## How Can I Contribute? @@ -77,14 +77,14 @@ As for bugs please be precise in your suggestions: ### First Code Contribution The first step is always the hardest. None of us is Linus Torvalds. This is the first open project for most of us so don't feel intimidated, we are learning, too. -At least try to follow the guidelines you find [here](#contributing-to-edflow) +At least try to follow the [guidelines](#contributing-to-edflow). ### Pull Requests Please follow these steps when contributing: -1. Follow all instructions in [the template](PULL_REQUEST_TEMPLATE.md) -2. Follow the [styleguides](#styleguides) +1. Add notable changes to the [CHANGELOG.md](CHANGELOG.md). +2. Follow the [styleguides](#styleguides). 3. After you submit your pull request, verify that all [tests](https://travis-ci.org/pesser/edflow/) are passing. This makes working together easier for all of us. @@ -115,7 +115,7 @@ This makes working together easier for all of us. ### Code Styleguide -Just remember to use black (This is necessary to pass the tests) +Just remember to use black (This is necessary to pass the tests).