Skip to content

Commit 281a426

Browse files
authored
Changes to get the repo ready for the sprint (#281)
* some changes to get everything ready for the sprint * add categories to notebook proposal form * remove old tables of contents tutorial/examples * remove old toc check * add link to webinar in contributing
1 parent fe396c1 commit 281a426

File tree

6 files changed

+23
-156
lines changed

6 files changed

+23
-156
lines changed

.github/ISSUE_TEMPLATE/notebook-proposal.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,12 @@ labels: proposal
99
**Title**: Use this also as issue title
1010

1111
## Why should this notebook be added to pymc-examples?
12-
Explain why this topic is interesting and useful to PyMC users.
12+
Explain why this topic is interesting and useful to PyMC users
13+
and what need of the PyMC users it aims to answer.
14+
15+
Suggested categories:
16+
* Level:
17+
* [Diataxis](https://diataxis.fr/) type:
1318

1419
## Related notebooks
1520
Cover related notebooks on which this notebook will build,

.pre-commit-config.yaml

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -50,11 +50,6 @@ repos:
5050
minimum_pre_commit_version: 2.8.0
5151
name: Check notebooks have watermark (see Jupyter style guide from PyMC3 Wiki)
5252
types: [jupyter]
53-
- id: check-toc
54-
entry: python scripts/check_toc_is_complete.py
55-
language: python
56-
name: Check all notebooks appear in table of contents
57-
types: [jupyter]
5853
- id: add-tags
5954
entry: python scripts/add_tags.py
6055
language: python

CONTRIBUTING.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -17,18 +17,25 @@ This project serves as both tracker and organizer of the work needed on each of
1717
Each notebook will have its own issue where we can point out things to fix and discuss them.
1818
These issue tickets are placed on one of the columns in this project based on the state of the notebook:
1919

20-
* **To Do:** notebooks in this column are outdated, don't use ArviZ or InferenceData (or do so only partially), use deprecated pymc3 arguments or show other practices that should be updated and improved.
21-
* **General updates:** notebooks in this column have pymc3 code up to date with v3, but don't use ArviZ (or do so only partially)
22-
* **ArviZ:** notebooks in this column use ArviZ but still have bad examples of pymc3 usage.
23-
* **Best practices:** notebooks in this column use ArviZ and pymc3 best practices. This column alone does not represent any extra updates, it is only the place for notebooks fulfilling the requirements to be in both "general updates" and "ArviZ".
24-
* **v4:** notebooks in this column use ArviZ and have been updated and executed with pymc3 v4.
20+
* **To Do:** notebooks in this column are potentially outdated, run on v3, don't follow the style guide,
21+
don't use best practices when using PyMC...
22+
* **Best practices (v3):** notebooks in this column use ArviZ and PyMC v3 best practices.
23+
* **v4 (auto)**: Notebooks in this column have been updated and reexecuted with PyMC v4,
24+
but following v3 style and patterns, and are not taking advantage of the new features
25+
introduced in v4.
26+
* **Book style**: Notebooks in this column have had their content, style and formatting updated
27+
to take advantage of all the pymc-examples website features, but still need work
28+
on the code side (either because they still use v3 or because they use v4 but don't
29+
take advantage of its new features). There is a [webinar](https://pymc-data-umbrella.xyz/en/latest/webinars/contributing_to_documentation/index.html)
30+
about the pymc examples repo and contributing to it, part of the PyMC Data Umbrella series.
31+
* **Done:** notebooks in this column use ArviZ and have been updated and executed with pymc3 v4.
2532

2633
Therefore, all notebooks will be progressively updated along this path:
2734

2835
```
29-
/ --> General updates -- \
30-
To Do --< >--> Best Practices --> v4
31-
\ --> ArviZ -- /
36+
/ --> Book style -- \
37+
To Do --> Best Practices (v3) --< >--> Done
38+
\ --> v4 (auto) -- /
3239
```
3340

3441
See https://github.com/pymc-devs/pymc-examples/wiki/Notebook-updates-overview for a more detailed
@@ -39,13 +46,8 @@ Before starting a work on a pull request look at the tracker issue of the
3946
notebook you are planning to edit to make sure it is not being updated by someone
4047
else.
4148

42-
**Note on labels**: The labels on an issue will apply to the most immediate 1 position update.
43-
One issue can be labeled "good first issue" for updating from "To Do" to "General updates", but
44-
that does not mean that updating from "To Do"->"ArviZ" or
45-
"General Updates"->"Best Practices" won't be challenging.
46-
The same could be true the other way around.
47-
In case of doubt, don't hesitate to ask and read over the notebook to
48-
see what changes are expected.
49+
**Note on labels**: The labels on an issue generally apply to potential code changes.
50+
You should ignore them if you are looking at content/style updates only.
4951

5052
If there are no comments and nobody is working on this notebook,
5153
comment on the ticket to make it evident to others, we will assign

examples/table_of_contents_examples.js

Lines changed: 0 additions & 82 deletions
This file was deleted.

examples/table_of_contents_tutorials.js

Lines changed: 0 additions & 26 deletions
This file was deleted.

scripts/check_toc_is_complete.py

Lines changed: 0 additions & 27 deletions
This file was deleted.

0 commit comments

Comments
 (0)