Skip to content

Commit 889cf84

Browse files
authored
Added admonition for not accepting community contributions and updated Python versions. (#3866)
1 parent 664f1db commit 889cf84

File tree

2 files changed

+51
-47
lines changed

2 files changed

+51
-47
lines changed

CONTRIBUTING.md

Lines changed: 29 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -4,29 +4,26 @@
44
<p vertical-align="middle"><h1>Contributing</h1></p>
55

66
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[![Discourse topics](https://img.shields.io/discourse/topics?color=8A08E6&label=Connect%20&labelColor=FFDF58&logo=Discourse&logoColor=8A08E6&server=https%3A%2F%2Fforum.exercism.org&style=social)](https://forum.exercism.org)
7-
&nbsp;&nbsp;[![Exercism_II](https://img.shields.io/badge/Exercism--Built-9101FF?logo=python&logoColor=FFDF58&labelColor=3D7AAB&label=Python%203.10%20Powered)](https://exercism.org)
7+
&nbsp;&nbsp;[![Exercism_II](https://img.shields.io/badge/Exercism--Built-9101FF?logo=python&logoColor=FFDF58&labelColor=3D7AAB&label=Python%203.11%20Powered)](https://exercism.org)
88
&nbsp;&nbsp;[![Exercism_III](https://img.shields.io/badge/PAUSED-C73D4E?labelColor=3D454D&label=Contributions)](https://exercism.org/blog/freeing-our-maintainers)
99
&nbsp; [![Build Status](https://github.com/exercism/python/workflows/Exercises%20check/badge.svg)](https://github.com/exercism/python/actions?query=workflow%3A%22Exercises+check%22)
1010

11-
---
12-
---
1311

14-
### We are not accepting community contributions at this time.
12+
> [!IMPORTANT]
13+
> <h3><mark><b>We are not accepting community contributions at this time.</b></mark></h3>
14+
> <table>
15+
> <tr>
16+
> <img align="left" width="95" height="95" src="https://github.com/exercism/website-icons/blob/main/exercises/health-statistics.svg">
17+
>
18+
> We love our community. We're grateful you are interested in improving the Python track.
19+
> But our maintainers are **not accepting community contributions at this time.**
20+
> If you would like to discuss possible future changes, <mark><b>please open a [thread on the forum](https://forum.exercism.org/).</b></mark>
21+
>
22+
> This [community blog post](https://exercism.org/blog/freeing-our-maintainers) contains more details.
23+
>
24+
> </tr>
25+
> </table>
1526
16-
<table>
17-
<tr>
18-
<img align="left" width="90" height="85" src="https://github.com/exercism/website-icons/blob/main/exercises/health-statistics.svg">
19-
20-
We're grateful for your interested in helping improve the Python track. but our maintainers are **not accepting community contributions at this time.**
21-
If you would like to discuss possible future changes, please open a [thread on the forum](https://forum.exercism.org/).
22-
23-
This [community blog post](https://exercism.org/blog/freeing-our-maintainers) contains more details.
24-
25-
</tr>
26-
</table>
27-
28-
---
29-
---
3027

3128
<br>
3229

@@ -35,7 +32,7 @@ Hi. &nbsp;👋🏽 &nbsp;👋 &nbsp;**We are happy you are here.**&nbsp; 🎉&nb
3532
**`exercism/Python`** is one of many programming language tracks on [exercism(dot)org][exercism-website].
3633
This repo holds all the instructions, tests, code, & support files for Python _exercises_ currently under development or implemented & available for students.
3734

38-
🌟 &nbsp;&nbsp;Track exercises support Python `3.7` - `3.11.2`.
35+
🌟 &nbsp;&nbsp;Track exercises support Python `3.7` - `3.11.5`.
3936
Exceptions to this support are noted where they occur.
4037
🌟 &nbsp;&nbsp;Track tooling (_test-runner, representer, analyzer, and Continuous Integration_) runs on Python `3.11.2`.
4138

@@ -50,20 +47,25 @@ Practice exercises are open-ended, and can be used to practice concepts learned,
5047
It is not uncommon to discover typos, confusing directions, or incorrect implementations of certain tests or code examples. Or you might have a great suggestion for a hint to aid students (&nbsp;💙 &nbsp;), see optimizations for exemplar or test code, find missing test cases to add, or want to correct factual and/or logical errors. Or maybe you have a great idea 💡 for an exercise or feature (&nbsp;💙&nbsp;).
5148

5249
_Our track is always a work in progress!_ 🌟🌟
53-
While contributions are paused, we ask that you [`open a thread in our community forum`](https://forum.exercism.org) to let us know what you have found/suggest.
50+
While contributions are paused, we ask that you <mark>[**open a thread in our community forum**](https://forum.exercism.org)</mark> to let us know what you have found/suggest.
5451

5552
<br>
5653

5754
## 🚧 **Did you write a patch that fixes a bug?**
5855

59-
**`Our maintainers are not accepting community contributions at this time.`**
60-
Please read this [community blog post](https://exercism.org/blog/freeing-our-maintainers) for details.
56+
<mark><b>Our maintainers are not accepting community contributions at this time.</b></mark>
57+
<br>
58+
Until the pause on contributions ends, all PRs from the larger community will be **automatically closed** with a note.
59+
We ask that you <mark>[**open a thread in our community forum**](https://forum.exercism.org)</mark> to discuss any potential changes. Changes may or may not be approved, depending on the forum discussion.
6160

62-
Once the pause ends, we will **happily** consider your PR.
63-
Until that time, all PRs from the larger community will be **automatically closed** with a note.
61+
Please read this [community blog post](https://exercism.org/blog/freeing-our-maintainers) for additional details.
62+
<br>
6463

65-
We're leaving the general contributing docs below for our long-term collaborators and maintainers.
64+
We're leaving the track contributing docs below for our long-term collaborators and maintainers.
6665

66+
<br>
67+
<details>
68+
<summary><b>Python Track Contributing Docs</b></summary>
6769
<br>
6870
<img align="left" width="80" height="75" src="https://github.com/exercism/website-icons/blob/main/exercises/hello-world.svg">
6971
<p vertical-align="middle"><h2 id="in-general">In General</h2></p>
@@ -376,45 +378,32 @@ configlet generate <path/to/track> --spec-path path/to/problem/specifications --
376378
configlet generate <path/to/track> --spec-path path/to/problem/specifications
377379
```
378380
381+
379382
<br>
383+
</details>
380384
381385
382386
[.flake8]: https://github.com/exercism/python/blob/main/.flake8
383387
[.style.yapf]: https://github.com/exercism/python/blob/main/.style.yapf
384388
[american-english]: https://github.com/exercism/docs/blob/main/building/markdown/style-guide.md
385-
[being-a-good-community-member]: https://github.com/exercism/docs/tree/main/community/good-member
386389
[card-games-testfile]: https://github.com/exercism/python/blob/main/exercises/concept/card-games/lists_test.py
387390
[cater-waiter]: https://github.com/exercism/python/tree/main/exercises/concept/cater-waiter
388391
[concept-exercise-anatomy]: https://github.com/exercism/docs/blob/main/building/tracks/concept-exercises.md
389-
[concept-exercises]: https://github.com/exercism/docs/blob/main/building/tracks/concept-exercises.md
390392
[config-json]: https://github.com/exercism/javascript/blob/main/config.json
391-
[config-json]: https://github.com/exercism/python/blob/main/config.json
392-
[configlet-general]: https://github.com/exercism/configlet
393393
[configlet-lint]: https://github.com/exercism/configlet#configlet-lint
394394
[configlet]: https://github.com/exercism/docs/blob/main/building/configlet/generating-documents.md
395395
[distinguishing-test-iterations]: https://docs.python.org/3/library/unittest.html#distinguishing-test-iterations-using-subtests
396396
[enumerate]: https://docs.python.org/3/library/functions.html#enumerate
397397
[eol]: https://en.wikipedia.org/wiki/Newline
398398
[exercise-config-json]: https://github.com/exercism/docs/blob/main/building/tracks/concept-exercises.md#full-example
399-
[exercise-presentation]: https://github.com/exercism/docs/blob/main/building/tracks/presentation.md
400-
[exercism-admins]: https://github.com/exercism/docs/blob/main/community/administrators.md
401-
[exercism-code-of-conduct]: https://exercism.org/docs/using/legal/code-of-conduct
402-
[exercism-concepts]: https://github.com/exercism/docs/blob/main/building/tracks/concepts.md
403-
[exercism-contributors]: https://github.com/exercism/docs/blob/main/community/contributors.md
404399
[exercism-internal-linking]: https://github.com/exercism/docs/blob/main/building/markdown/internal-linking.md
405400
[exercism-markdown-specification]: https://github.com/exercism/docs/blob/main/building/markdown/markdown.md
406401
[exercism-markdown-widgets]: https://github.com/exercism/docs/blob/main/building/markdown/widgets.md
407-
[exercism-mentors]: https://github.com/exercism/docs/tree/main/mentoring
408-
[exercism-tasks]: https://exercism.org/docs/building/product/tasks
409-
[exercism-track-maintainers]: https://github.com/exercism/docs/blob/main/community/maintainers.md
410-
[exercism-track-structure]: https://github.com/exercism/docs/tree/main/building/tracks
411402
[exercism-website]: https://exercism.org/
412-
[exercism-writing-style]: https://github.com/exercism/docs/blob/main/building/markdown/style-guide.md
413403
[flake8-noqa]: https://flake8.pycqa.org/en/3.1.1/user/ignoring-errors.html#in-line-ignoring-errors
414404
[flake8]: http://flake8.pycqa.org/
415405
[google-coding-style]: https://google.github.io/styleguide/pyguide.html
416406
[guidos-gorgeous-lasagna-testfile]: https://github.com/exercism/python/blob/main/exercises/concept/guidos-gorgeous-lasagna/lasagna_test.py
417-
[help-wanted]: https://github.com/exercism/python/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22
418407
[implicit-line-joining]: https://google.github.io/styleguide/pyguide.html#32-line-length
419408
[markdown-language]: https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf
420409
[open-an-issue]: https://github.com/exercism/python/issues/new/choose
@@ -436,5 +425,4 @@ configlet generate <path/to/track> --spec-path path/to/problem/specifications
436425
[the-words-that-we-use]: https://github.com/exercism/docs/blob/main/community/good-member/words.md
437426
[unittest]: https://docs.python.org/3/library/unittest.html#unittest.TestCase
438427
[version-tagged-language-features]: https://docs.python.org/3/library/stdtypes.html#dict.popitem
439-
[website-contributing-section]: https://exercism.org/docs/building
440428
[yapf]: https://github.com/google/yapf

README.md

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,27 @@
1010

1111
<br>
1212

13-
Hi. &nbsp;👋🏽 &nbsp;👋 &nbsp;**We are happy you are here.**&nbsp; 🎉&nbsp;🌟
13+
> [!IMPORTANT]
14+
> <h3><mark><b>We are not accepting community contributions at this time.</b></mark></h3>
15+
> <table>
16+
> <tr>
17+
> <img align="left" width="95" height="95" src="https://github.com/exercism/website-icons/blob/main/exercises/health-statistics.svg">
18+
>
19+
> We love our community. We're grateful you are interested in improving the Python track.
20+
> But our maintainers are **not accepting community contributions at this time.**
21+
> If you would like to suggest a change or discuss an issue, <mark><b>please open a [thread on the forum](https://forum.exercism.org/).</b></mark>
22+
>
23+
> This [community blog post](https://exercism.org/blog/freeing-our-maintainers) contains more details.
24+
>
25+
> </tr>
26+
> </table>
1427
1528
<br>
1629

30+
Hi. &nbsp;👋🏽 &nbsp;👋 &nbsp;**We are happy you are here.**&nbsp; 🎉&nbsp;🌟
31+
32+
<br><br>
33+
1734
**`exercism/Python`** is one of many programming language tracks on [exercism(dot)org][exercism-website].
1835
This repo holds all the instructions, tests, code, & support files for Python _exercises_ currently under development or implemented & available for students.
1936

@@ -43,15 +60,15 @@ It might also be helpful to look at [Being a Good Community Member][being-a-good
4360
<br>
4461
<img align="left" width="90" height="85" src="https://github.com/exercism/website-icons/blob/main/exercises/health-statistics.svg">
4562

46-
We&nbsp;💛&nbsp;💙 &nbsp; our community.
47-
**`But our maintainers are not accepting community contributions at this time.`**
63+
We&nbsp;💛&nbsp;💙 our community.
64+
<mark>**But our maintainers are not accepting community contributions at this time.**</mark>
4865
Please read this [community blog post][freeing-maintainers] for details.
4966

5067
<br>
5168
<img align="left" width="95" height="90" src="https://github.com/exercism/website-icons/blob/main/exercises/boutique-suggestions.svg">
5269

5370
Here to suggest a new feature or new exercise?? **Hooray!** &nbsp;🎉 &nbsp;
54-
We'd love if you did that via our [Exercism Community Forum](https://forum.exercism.org/).
71+
We'd love if you did that via our [Community Forum](https://forum.exercism.org/).
5572
Please read [Suggesting Exercise Improvements][suggesting-improvements] & [Chesterton's Fence][chestertons-fence].
5673
_Thoughtful suggestions will likely result in faster & more enthusiastic responses from volunteers._
5774

@@ -67,7 +84,7 @@ _Thoughtful suggestions will likely result in faster & more enthusiastic respons
6784

6885
## Python Software and Documentation
6986

70-
**Copyright © 2001-2023 Python Software Foundation. All rights reserved.**
87+
**Copyright © 2001-2025 Python Software Foundation. All rights reserved.**
7188

7289
Python software and documentation are licensed under the [PSF License Agreement][psf-license].
7390

@@ -99,7 +116,6 @@ This repository uses the [MIT License](/LICENSE).
99116
[exercism-writing-style]: https://github.com/exercism/docs/blob/main/building/markdown/style-guide.md
100117
[freeing-maintainers]: https://exercism.org/blog/freeing-our-maintainers
101118
[practice-exercises]: https://github.com/exercism/docs/blob/main/building/tracks/practice-exercises.md
102-
[prs]: https://github.com/exercism/docs/blob/main/community/good-member/pull-requests.md
103119
[psf-license]: https://docs.python.org/3/license.html#psf-license
104120
[python-syllabus]: https://exercism.org/tracks/python/concepts
105121
[suggesting-improvements]: https://github.com/exercism/docs/blob/main/community/good-member/suggesting-exercise-improvements.md

0 commit comments

Comments
 (0)