wtfpython/CONTRIBUTING.md

36 lines
1.1 KiB
Markdown
Raw Normal View History

2018-01-22 10:12:35 +01:00
All kinds of patches are welcome. Feel free to even suggest some catchy and funny titles for the existing Examples. The goal is to make this collection as interesting to read as possible.
2017-09-11 18:20:33 +02:00
If the changes you suggest are siginificant, filing an issue before submitting the actual patch will be appreciated. If you'd like to work on the issue (highly encouraged), you can mention that you're interested in working on it while creating the issue and get assigned to it.
If you're adding a new example, please do create an issue to discuss it before submitting a patch.
2017-08-31 15:41:20 +02:00
You can use the following template for adding a new example:
2017-08-31 15:43:00 +02:00
<pre>
2018-01-22 10:12:35 +01:00
### ▶ Some fancy Title
2017-08-31 15:43:00 +02:00
```py
# Setting up the code.
# Preparation for the magic...
2017-08-31 15:41:20 +02:00
```
2017-08-31 15:43:00 +02:00
**Output (Python version):**
```py
>>> triggering_statement
Probably unexpected output
```
(Optional): One line describing the unexpected output.
#### 💡 Explanation:
* Brief explanation of what's happening and why is it happening.
2017-08-31 15:41:20 +02:00
```py
2017-08-31 15:43:00 +02:00
Setting up examples for clarification (if necessary)
2017-08-31 15:41:20 +02:00
```
2017-08-31 15:43:00 +02:00
**Outupt:**
2017-08-31 15:41:20 +02:00
```py
2017-08-31 15:43:00 +02:00
>>> trigger # some example that makes it easy to unveil the magic
# some justified output
2017-08-31 15:41:20 +02:00
```
```
2017-08-31 15:43:00 +02:00
</pre>