Skip to content

Commit 15d0984

Browse files
committed
Moved the contributing to django-tasks-scheduler underneath the sponsor and badges for readme for developers and contributors to see it quickly. Also added in a &nbsp on the docs for the badges to fix the hyperlink pypi link
1 parent 6d75017 commit 15d0984

File tree

2 files changed

+253
-2
lines changed

2 files changed

+253
-2
lines changed

README.md

Lines changed: 251 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
<!-- omit in toc -->
2+
3+
14
Django Tasks Scheduler
25
===================
36
[![Django CI](https://github.com/django-commons/django-tasks-scheduler/actions/workflows/test.yml/badge.svg)](https://github.com/django-commons/django-tasks-scheduler/actions/workflows/test.yml)
@@ -13,3 +16,251 @@ django-tasks-scheduler is developed for free.
1316
You can support this project by becoming a sponsor using [this link](https://github.com/sponsors/cunla).
1417

1518

19+
20+
21+
22+
# Contributing to django-tasks-scheduler
23+
24+
First off, thanks for taking the time to contribute! ❤️
25+
26+
All types of contributions are encouraged and valued. See the [Table of Contents](#table-of-contents) for different ways
27+
to help and details about how this project handles them. Please make sure to read the relevant section before making
28+
your contribution. It will make it a lot easier for us maintainers and smooth out the experience for all involved. The
29+
community looks forward to your contributions. 🎉
30+
31+
> And if you like the project, but just don't have time to contribute, that's fine. There are other easy ways to support
32+
> the project and show your appreciation, which we would also be very happy about:
33+
> - Star the project
34+
> - Tweet about it
35+
> - Refer to this project in your project's readme
36+
> - Mention the project at local meetups and tell your friends/colleagues
37+
38+
<!-- omit in toc -->
39+
40+
## Table of Contents
41+
42+
- [Django Tasks Scheduler](#django-tasks-scheduler)
43+
- [Sponsor](#sponsor)
44+
- [Contributing to django-tasks-scheduler](#contributing-to-django-tasks-scheduler)
45+
- [Table of Contents](#table-of-contents)
46+
- [Code of Conduct](#code-of-conduct)
47+
- [I Have a Question](#i-have-a-question)
48+
- [I Want To Contribute](#i-want-to-contribute)
49+
- [Reporting Bugs](#reporting-bugs)
50+
- [Before Submitting a Bug Report](#before-submitting-a-bug-report)
51+
- [How Do I Submit a Good Bug Report?](#how-do-i-submit-a-good-bug-report)
52+
- [Suggesting Enhancements](#suggesting-enhancements)
53+
- [Before Submitting an Enhancement](#before-submitting-an-enhancement)
54+
- [How Do I Submit a Good Enhancement Suggestion?](#how-do-i-submit-a-good-enhancement-suggestion)
55+
- [Your First Code Contribution](#your-first-code-contribution)
56+
- [Improving The Documentation](#improving-the-documentation)
57+
- [Style guides](#style-guides)
58+
- [Commit Messages](#commit-messages)
59+
- [Join The Project Team](#join-the-project-team)
60+
- [Attribution](#attribution)
61+
62+
## Code of Conduct
63+
64+
This project and everyone participating in it is governed by the
65+
[django-tasks-scheduler Code of Conduct](https://github.com/django-commons/django-tasks-scheduler/blob/main/CODE_OF_CONDUCT.md).
66+
By participating, you are expected to uphold this code. Please report unacceptable behavior
67+
68+
69+
## I Have a Question
70+
71+
> If you want to ask a question, we assume that you have read the
72+
> available [Documentation](https://github.com/django-commons/django-tasks-scheduler).
73+
74+
Before you ask a question, it is best to search for
75+
existing [Issues](https://github.com/django-commons/django-tasks-scheduler/issues) that might help you. In case you have
76+
found a suitable issue and still need clarification, you can write your question in this issue. It is also advisable to
77+
search the internet for answers first.
78+
79+
If you then still feel the need to ask a question and need clarification, we recommend the following:
80+
81+
- Open an [Issue](https://github.com/django-commons/django-tasks-scheduler/issues/new).
82+
- Provide as much context as you can about what you're running into.
83+
- Provide project and platform versions (nodejs, npm, etc), depending on what seems relevant.
84+
85+
We will then take care of the issue as soon as possible.
86+
87+
<!--
88+
You might want to create a separate issue tag for questions and include it in this description. People should then tag their issues accordingly.
89+
90+
Depending on how large the project is, you may want to outsource the questioning, e.g., to Stack Overflow or Gitter. You may add additional contact and information possibilities:
91+
- IRC
92+
- Slack
93+
- Gitter
94+
- Stack Overflow tag
95+
- Blog
96+
- FAQ
97+
- Roadmap
98+
- E-Mail List
99+
- Forum
100+
-->
101+
102+
## I Want To Contribute
103+
104+
> ### Legal Notice <!-- omit in toc -->
105+
> When contributing to this project, you must agree that you have authored 100% of the content, that you have the
106+
> necessary rights to the content and that the content you contribute may be provided under the project license.
107+
108+
### Reporting Bugs
109+
110+
<!-- omit in toc -->
111+
112+
#### Before Submitting a Bug Report
113+
114+
A good bug report shouldn't leave others needing to chase you up for more information. Therefore, we ask you to
115+
investigate carefully, collect information and describe the issue in detail in your report. Please complete the
116+
following steps in advance to help us fix any potential bug as fast as possible.
117+
118+
- Make sure that you are using the latest version.
119+
- Determine if your bug is really a bug and not an error on your side, e.g., using incompatible environment
120+
components/versions (Make sure that you have read
121+
the [documentation](https://github.com/django-commons/django-tasks-scheduler). If you are looking for support, you might
122+
want to check [this section](#i-have-a-question)).
123+
- To see if other users have experienced (and potentially already solved) the same issue you are having, check if there
124+
is not already a bug report existing for your bug or error in
125+
the [bug tracker](https://github.com/django-commons/django-tasks-scheduler/issues?q=label%3Abug).
126+
- Also make sure to search the internet (including Stack Overflow) to see if users outside the GitHub community have
127+
discussed the issue.
128+
- Collect information about the bug:
129+
- Stack trace (Traceback)
130+
- OS, Platform and Version (Windows, Linux, macOS, x86, ARM)
131+
- Version of the interpreter, compiler, SDK, runtime environment, package manager, depending on what seems relevant.
132+
- Possibly your input and the output
133+
- Can you reliably reproduce the issue? And can you also reproduce it with older versions?
134+
135+
<!-- omit in toc -->
136+
137+
#### How Do I Submit a Good Bug Report?
138+
139+
> You must never report security related issues, vulnerabilities or bugs, including sensitive information to the issue
140+
> tracker, or elsewhere in public. Instead, sensitive bugs must be sent by email to <[email protected]>.
141+
<!-- You may add a PGP key to allow the messages to be sent encrypted as well. -->
142+
143+
We use GitHub issues to track bugs and errors. If you run into an issue with the project:
144+
145+
- Open an [Issue](https://github.com/django-commons/django-tasks-scheduler/issues/new).
146+
(Since we can't be sure at this point whether it is a bug or not, we ask you not to talk about a bug yet and
147+
not to label the issue.)
148+
- Explain the behavior you would expect and the actual behavior.
149+
- Please provide as much context as possible and describe the *reproduction steps* that someone else can follow to
150+
recreate the issue on their own. This usually includes your code.
151+
For good bug reports, you should isolate the problem and create a reduced test case.
152+
- Provide the information you collected in the previous section.
153+
154+
Once it's filed:
155+
156+
- The project team will label the issue accordingly.
157+
- A team member will try to reproduce the issue with your provided steps. If there are no reproduction steps or no
158+
obvious way to reproduce the issue, the team will ask you for those steps and mark the issue as `needs-repro`. Bugs
159+
with the `needs-repro` tag will not be addressed until they are reproduced.
160+
- If the team is able to reproduce the issue, it will be marked `needs-fix`, as well as possibly other tags (such
161+
as `critical`), and the issue will be left to be [implemented by someone](#your-first-code-contribution).
162+
163+
<!-- You might want to create an issue template for bugs and errors that can be used as a guide and that defines the structure of the information to be included. If you do so, reference it here in the description. -->
164+
165+
### Suggesting Enhancements
166+
167+
This section guides you through submitting an enhancement suggestion for django-tasks-scheduler, **including completely
168+
new
169+
features and minor improvements to existing functionality**. Following these guidelines will help maintainers and the
170+
community to understand your suggestion and find related suggestions.
171+
172+
<!-- omit in toc -->
173+
174+
#### Before Submitting an Enhancement
175+
176+
- Make sure that you are using the latest version.
177+
- Read the [documentation](https://github.com/django-commons/django-tasks-scheduler) carefully and find out if the
178+
functionality is already covered, maybe by an individual configuration.
179+
- Perform a [search](https://github.com/django-commons/django-tasks-scheduler/issues) to see if the enhancement has
180+
already
181+
been suggested. If it has, add a comment to the existing issue instead of opening a new one.
182+
- Find out whether your idea fits with the scope and aims of the project. It's up to you to make a strong case to
183+
convince the project's developers of the merits of this feature. Keep in mind that we want features that will be
184+
useful to the majority of our users and not just a small subset. If you're just targeting a minority of users,
185+
consider writing an add-on/plugin library.
186+
187+
<!-- omit in toc -->
188+
189+
#### How Do I Submit a Good Enhancement Suggestion?
190+
191+
Enhancement suggestions are tracked as [GitHub issues](https://github.com/django-commons/django-tasks-scheduler/issues).
192+
193+
- Use a **clear and descriptive title** for the issue to identify the suggestion.
194+
- Provide a **step-by-step description of the suggested enhancement** in as many details as possible.
195+
- **Describe the current behavior** and **explain which behavior you expected to see instead** and why. At this point
196+
you can also tell which alternatives do not work for you.
197+
- You may want to **include screenshots and animated GIFs** which help you demonstrate the steps or point out the part
198+
which the suggestion is related to. You can use [this tool](https://www.cockos.com/licecap/) to record GIFs on macOS
199+
and Windows, and [this tool](https://github.com/colinkeenan/silentcast)
200+
or [this tool](https://github.com/GNOME/byzanz) on
201+
Linux. <!-- this should only be included if the project has a GUI -->
202+
- **Explain why this enhancement would be useful** to most django-tasks-scheduler users. You may also want to point out
203+
the
204+
other projects that solved it better and which could serve as inspiration.
205+
206+
<!-- You might want to create an issue template for enhancement suggestions that can be used as a guide and that defines the structure of the information to be included. If you do so, reference it here in the description. -->
207+
208+
### Your First Code Contribution
209+
210+
Unsure where to begin contributing? You can start by looking through
211+
[help-wanted issues](https://github.com/django-commons/django-tasks-scheduler/labels/help%20wanted).
212+
213+
Never contributed to open source before? Here are a couple of friendly
214+
tutorials:
215+
216+
- <http://makeapullrequest.com/>
217+
- <http://www.firsttimersonly.com/>
218+
219+
### Improving The Documentation
220+
221+
- Create your own fork of the repository
222+
- Do the changes in your fork.
223+
- Create a pull request with the changes.
224+
225+
## Style guides
226+
227+
### Commit Messages
228+
229+
Taken from [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/)
230+
231+
```
232+
<type>[optional scope]: <description>
233+
234+
[optional body]
235+
236+
[optional footer(s)]
237+
```
238+
239+
The commit message contains the following structural elements,
240+
in order to communicate intent to the consumers of your library:
241+
242+
* `fix:` a commit of the type fix patches a bug in your codebase (this correlates with `PATCH` in Semantic Versioning).
243+
* `feat:` a commit of the type feat introduces a new feature to the codebase (this correlates with `MINOR` in Semantic
244+
Versioning).
245+
* `BREAKING CHANGE:` a commit that has a footer BREAKING CHANGE:, or appends a ! after the type/scope, introduces a
246+
breaking API change (correlating with MAJOR in Semantic Versioning). A BREAKING CHANGE can be part of commits of any
247+
type.
248+
* types other than `fix:` and `feat:` are allowed, for example, @commitlint/config-conventional (based on the Angular
249+
convention) recommends `build:`, `chore:`, `ci:`, `docs:`, `style:`, `refactor:`, `perf:`, `test:`, and others.
250+
* footers other than `BREAKING CHANGE: <description>` may be provided and follow a convention similar to
251+
[git trailer format](https://git-scm.com/docs/git-interpret-trailers).
252+
253+
Additional types are not mandated by the Conventional Commits specification, and have no implicit effect in Semantic
254+
Versioning (unless they include a BREAKING CHANGE). A scope may be provided to a commit’s type, to provide additional
255+
contextual information and is contained within parenthesis, e.g., feat(parser): add ability to parse arrays.
256+
257+
## Join The Project Team
258+
259+
If you wish to be added to the project team as a collaborator, please create an issue
260+
explaining why you wish to join the team and tag @cunla in the issue.
261+
262+
<!-- omit in toc -->
263+
264+
## Attribution
265+
266+
This guide is based on the **contributing-gen**. [Make your own](https://github.com/bttger/contributing-gen)!

docs/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Django tasks Scheduler
22

33
[![Django CI][badge]][2]
4-
![badge][coverage]
5-
[![badge][pypi-downloads]][pypi]
4+
![badge][coverage]&nbsp;
5+
[![downloads][pypi-downloads]][pypi]
66

77
---
88

0 commit comments

Comments
 (0)