Skip to content

Commit e23c921

Browse files
authored
Merge pull request #28 from Materials-Data-Science-and-Informatics/fix/issue_tracker
remove symlink and fix repo url
2 parents 81fa36f + a75e16f commit e23c921

File tree

2 files changed

+76
-17
lines changed

2 files changed

+76
-17
lines changed

CONTRIBUTING.md

Lines changed: 0 additions & 1 deletion
This file was deleted.

CONTRIBUTING.md

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# How To Contribute
2+
3+
All kinds of contributions are very welcome!
4+
You can contribute in various ways, e.g. by
5+
6+
- providing feedback
7+
- asking questions
8+
- suggesting ideas
9+
- implementing features
10+
- fixing problems
11+
- improving documentation
12+
13+
To make contributing to open source projects a good experience to everyone involved,
14+
please make sure that you follow our code of conduct when communicating with others.
15+
16+
## Ideas, Questions and Problems
17+
18+
If you have questions or difficulties using this software,
19+
please use the [issue tracker](https://github.com/Materials-Data-Science-and-Informatics/fair-python-cookiecutter/issues).
20+
21+
If your topic is not already covered by an existing issue,
22+
please create a new issue using one of the provided issue templates.
23+
24+
If your issue is caused by incomplete, unclear or outdated documentation,
25+
we are also happy to get suggestions on how to improve it.
26+
Outdated or incorrect documentation is a _bug_,
27+
while missing documentation is a _feature request_.
28+
29+
**NOTE:** If you want to report a critical security problem, _do not_ open an issue!
30+
Instead, please create a [private security advisory](https://docs.github.com/en/code-security/security-advisories/guidance-on-reporting-and-writing/privately-reporting-a-security-vulnerability),
31+
or contact the current package maintainers directly by e-mail.
32+
33+
## Development
34+
35+
This project uses [Poetry](https://python-poetry.org/) for dependency management.
36+
37+
You can run the following lines to check out the project and prepare it for development:
38+
39+
```
40+
git clone https://github.com/Materials-Data-Science-and-Informatics/fair-python-cookiecutter.git
41+
cd fair-python-cookiecutter
42+
poetry install --with docs
43+
poetry run poe init-dev
44+
```
45+
46+
Common tasks are accessible via [poe](https://github.com/nat-n/poethepoet):
47+
48+
- Use `poetry run poe lint` to run linters manually, add `--all-files` to check everything.
49+
50+
- Use `poetry run poe test` to run tests, add `--cov` to also show test coverage.
51+
52+
- Use `poetry run poe docs` to generate local documentation
53+
54+
In order to contribute code, please open a pull request.
55+
56+
Before opening the PR, please make sure that your changes
57+
58+
- are sufficiently covered by meaningful **tests**,
59+
- are reflected in suitable **documentation** (API docs, guides, etc.), and
60+
- successfully pass all pre-commit hooks.

src/fair_python_cookiecutter/template/{{ cookiecutter.project_slug }}/CONTRIBUTING.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@
33
All kinds of contributions are very welcome!
44
You can contribute in various ways, e.g. by
55

6-
* providing feedback
7-
* asking questions
8-
* suggesting ideas
9-
* implementing features
10-
* fixing problems
11-
* improving documentation
6+
- providing feedback
7+
- asking questions
8+
- suggesting ideas
9+
- implementing features
10+
- fixing problems
11+
- improving documentation
1212

1313
To make contributing to open source projects a good experience to everyone involved,
1414
please make sure that you follow our code of conduct when communicating with others.
@@ -23,10 +23,10 @@ please create a new issue using one of the provided issue templates.
2323

2424
If your issue is caused by incomplete, unclear or outdated documentation,
2525
we are also happy to get suggestions on how to improve it.
26-
Outdated or incorrect documentation is a *bug*,
27-
while missing documentation is a *feature request*.
26+
Outdated or incorrect documentation is a _bug_,
27+
while missing documentation is a _feature request_.
2828

29-
**NOTE:** If you want to report a critical security problem, *do not* open an issue!
29+
**NOTE:** If you want to report a critical security problem, _do not_ open an issue!
3030
Instead, please create a [private security advisory](https://docs.github.com/en/code-security/security-advisories/guidance-on-reporting-and-writing/privately-reporting-a-security-vulnerability),
3131
or contact the current package maintainers directly by e-mail.
3232

@@ -37,24 +37,24 @@ This project uses [Poetry](https://python-poetry.org/) for dependency management
3737
You can run the following lines to check out the project and prepare it for development:
3838

3939
```
40-
git clone {{ cookiecutter.project_git_path }}
40+
git clone {{ cookiecutter.project_repo_url }}
4141
cd {{ cookiecutter.project_slug }}
4242
poetry install --with docs
4343
poetry run poe init-dev
4444
```
4545

4646
Common tasks are accessible via [poe](https://github.com/nat-n/poethepoet):
4747

48-
* Use `poetry run poe lint` to run linters manually, add `--all-files` to check everything.
48+
- Use `poetry run poe lint` to run linters manually, add `--all-files` to check everything.
4949

50-
* Use `poetry run poe test` to run tests, add `--cov` to also show test coverage.
50+
- Use `poetry run poe test` to run tests, add `--cov` to also show test coverage.
5151

52-
* Use `poetry run poe docs` to generate local documentation
52+
- Use `poetry run poe docs` to generate local documentation
5353

5454
In order to contribute code, please open a pull request.
5555

5656
Before opening the PR, please make sure that your changes
5757

58-
* are sufficiently covered by meaningful **tests**,
59-
* are reflected in suitable **documentation** (API docs, guides, etc.), and
60-
* successfully pass all pre-commit hooks.
58+
- are sufficiently covered by meaningful **tests**,
59+
- are reflected in suitable **documentation** (API docs, guides, etc.), and
60+
- successfully pass all pre-commit hooks.

0 commit comments

Comments
 (0)