diff --git a/.github/ISSUE_TEMPLATE/bug-report.md b/.github/ISSUE_TEMPLATE/bug-report.md new file mode 100644 index 000000000..6d2773780 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug-report.md @@ -0,0 +1,5 @@ +--- +name: 'Bug Report' +about: Inform about errors and mistakes in the notebooks + +--- diff --git a/.github/ISSUE_TEMPLATE/tracker.md b/.github/ISSUE_TEMPLATE/tracker.md new file mode 100644 index 000000000..acabf5519 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/tracker.md @@ -0,0 +1,38 @@ +--- +name: 'Tracker issue' +about: Create a tracker issue for the GitHub project +labels: tracker id + +--- + +File: +Reviewers: + +## Context + +## Known changes needed +Changes listed in this section should all be done at some point in order to get this +notebook to a "Best Practices" state. However, these are probably not enough! +Make sure to thoroughly review the notebook and search for other updates. + +### General updates +* + +### ArviZ related +* + +## Changes for discussion +Changes listed in this section are up for discussion, these are ideas on how to improve +the notebook but may not have a clear implementation, or fix some know issue only partially. + +### General updates +* + +### ArviZ related +* + +## Notes + +### Exotic dependencies + +### Computing power diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 000000000..26edbd95f --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,16 @@ +## Description + + +Addresses issue #xxx and aims to advance it to + + diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 000000000..dbae89e4d --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,78 @@ +# PyMC3 Code of Conduct + +## Our Pledge + +In the interest of fostering an open and welcoming environment, we as +contributors and maintainers pledge to making participation in our project and +our community a harassment-free experience for everyone, regardless of age, body +size, disability, ethnicity, sex characteristics, gender identity and expression, +level of experience, education, socio-economic status, nationality, personal +appearance, race, religion, or sexual identity and orientation. + +## Our Standards + +Examples of behavior that contributes to creating a positive environment +include: + +* Using welcoming and inclusive language +* Being respectful of differing viewpoints and experiences +* Gracefully accepting constructive criticism +* Focusing on what is best for the community +* Showing empathy towards other community members + +Examples of unacceptable behavior by participants include: + +* The use of sexualized language or imagery and unwelcome sexual attention or + advances +* Trolling, insulting/derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or electronic + address, without explicit permission +* Other conduct which could reasonably be considered inappropriate in a + professional setting + +## Our Responsibilities + +Project maintainers are responsible for clarifying the standards of acceptable +behavior and are expected to take appropriate and fair corrective action in +response to any instances of unacceptable behavior. + +Project maintainers have the right and responsibility to remove, edit, or +reject comments, commits, code, wiki edits, issues, and other contributions +that are not aligned to this Code of Conduct, or to ban temporarily or +permanently any contributor for other behaviors that they deem inappropriate, +threatening, offensive, or harmful. + +## Scope + +This Code of Conduct applies both within project spaces and in public spaces +when an individual is representing the project or its community. Examples of +representing a project or community include using an official project e-mail +address, posting via an official social media account, or acting as an appointed +representative at an online or offline event. Representation of a project may be +further defined and clarified by project maintainers. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported by contacting PyMC3 developer Christopher Fonnesbeck via email +(chris.fonnesbeck@vanderbilt.edu) or phone (615-955-0380). Alternatively, you +may also contact NumFOCUS Executive Director Leah Silen (512-222-5449) or +fill an anonymous report using [NumFOCUS Typeform](https://numfocus.typeform.com/to/ynjGdT). +As PyMC3 is a member of NumFOCUS and subscribes to their code of conduct as a +precondition for continued membership. All complaints will be reviewed and +investigated and will result in a response that is deemed necessary and +appropriate to the circumstances. The project team is obligated to maintain +confidentiality with regard to the reporter of an incident. Further details of +specific enforcement policies may be posted separately. + +Project maintainers who do not follow or enforce the Code of Conduct in good +faith may face temporary or permanent repercussions as determined by other +members of the project's leadership. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, +available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html + +[homepage]: https://www.contributor-covenant.org diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 000000000..8905ff61f --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,98 @@ +# Guidelines for Contributing +As part of the PyMC3 library documentation, the guidelines to contribute to +pymc-examples are based on [PyMC3 contributing guidelines](https://github.com/pymc-devs/pymc3/blob/master/CONTRIBUTING.md). Please refer there +for a detailed description of the Fork-PR contributing workflow, see "Steps" section, +and note that you'll need to update the repository URLs and branch names. + +This document therefore covers only some specific guidelines specific to this repository, mainly, +an adapted version of the "Pull Request Checklist" and some extra guidelines for +efficient collaboration with Jupyter notebooks. + +## Before submitting a pull request +The notebooks in pymc-examples are in the process of being updated and reexecuted. +The main progress tracker is [this GitHub project](https://github.com/pymc-devs/pymc-examples/projects/1). + +### About the notebook tracker project +This project serves as both tracker and organizer of the work needed on each of the example notebooks in this repo. +Each notebook will have its own issue where we can point out things to fix and discuss them. +These issue tickets are placed on one of the columns in this project based on the state of the notebook: + +* **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. +* **General updates:** notebooks in this column have pymc3 code up to date with v3, but don't use ArviZ (or do so only partially) +* **ArviZ:** notebooks in this column use ArviZ but still have bad examples of pymc3 usage. +* **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". +* **v4:** notebooks in this column use ArviZ and have been updated and executed with pymc3 v4. + +Therefore, all notebooks will be progressively updated along this path: + +``` + / --> General updates -- \ +To Do --< >--> Best Practices (--> v4) + \ --> ArviZ -- / +``` + +Each pull request should update a single notebook 1-2 positions to the right. +Before starting a work on a pull request look at the tracker issue of the +notebook you are planning to edit to make sure it is not being updated by someone +else. + +If there are no comments and nobody is working on this notebook, +comment on the ticket to make it evident to others, we will assign +the issue to you as soon as possible. +If the comment if more than two weeks old and there are no signs of +activity, leave a comment for a maintainer to assign the issue to you. + +We encourage you to submit a pull request as soon as possible after commenting +and being assigned the issue and +add `[WIP]` in the title to indicate Work in Progress. + +### About PR timeline +You are free and encouraged to work at your own pace as long as you keep +track of your progress in the issues and PRs. There is no deadline nor +maximum time an active PR can be open. + +There is a maximum time of 2 weeks for inactive PRs, +if there is no activity for two weeks, +we will close the PR and the issue will be unassigned. +We will try to ping you a few days before that happens, +but not being receiving such ping does not mean you won't get unassigned. + +If you know you won't be able to work during two weeks but plan to +continue your work afterwards, let us know by commenting when you'll be able +to retake the work. +Alternatively, you can also contact your reviewers on [Discourse](https://discourse.pymc.io/) + +As for review timeline, while you may get some reviews in a few hours or even some minutes +if we happen to be working on related things, _you should not expect that to be the norm_. +You should expect to receive review(s) for your PRs in 1-2 days. If two and a half days +after submitting you still have not received any comment, let us know (i.e. tag whoever +opened the issue you are addressing in a new PR comment. If at any point we were +overwhelmed by PRs and delay this timeline, we will comment on your PR with an estimate +of when you can expect a proper review. + +### In the event of a conflict +In the event of two or more people working on the same issue, +the general precedence will go to the person who first commented in the issue. +If no comments it will go to the first person to submit a PR for review. +Each situation will differ though, and the core contributors will make the best judgement call if needed. + +### If the issue ticket has someone assigned to it +If the issue is assigned then precedence goes to the assignee. +However if there has been no activity for 2 weeks from assignment date, +the ticket is open for all again and will be unassigned. + +## Pull request checklist + +We recommended that your contribution complies with the following guidelines before you submit a pull request: + +* Use the pull request title to describe the issue and mention the issue number in the pull request description. This will make sure a link back to the original issue is created. For example, use `Use ArviZ in sampler stats notebook` as a title and link to [#46](https://github.com/pymc-devs/pymc-examples/issues/46) in the description. + * Please do not submit PRs that are not addressing an issue already present in the issue tracker. + +* Prefix the title of incomplete contributions with `[WIP]` (to indicate a work in progress). WIPs may be useful to (1) indicate you are working on something to avoid duplicated work, (2) request broad review of functionality or API, or (3) seek collaborators. + +* Make sure to run the whole notebook sequentially on a fresh kernel. You can do that with the + "Restart & Run All" option before saving. + +* No `pre-commit` errors: see the [Jupyter Notebook style](https://github.com/pymc-devs/pymc3/wiki/PyMC3-Jupyter-Notebook-Style-Guide) (and [Python code style](https://github.com/pymc-devs/pymc3/wiki/PyMC3-Python-Code-Style)) page from our Wiki on how to install and run it. + +* Indicate how are you aiming to update the notebook (i.e. what is the target end column in the tracker). The pull request template has a template for this. diff --git a/README.rst b/README.rst index 0886ed240..ed447b89b 100644 --- a/README.rst +++ b/README.rst @@ -13,6 +13,30 @@ Check out the `getting started guide `__ forum. +Contributing +============ + +If you are interested in contributing to the example notebooks hosted here, please read the +`contributing guide `__ +Also read our `Code of Conduct `__ guidelines for a better contributing experience. + + +Contact +======= + +We are using `discourse.pymc.io `__ as our main communication channel. You can also follow us on `Twitter @pymc_devs `__ for updates and other announcements. + +To ask a question regarding modeling or usage of PyMC3 we encourage posting to our Discourse forum under the `“Questions” Category `__. You can also suggest feature in the `“Development” Category `__. + +To report an issue, please use the following: + +- `PyMC3 Examples - Issue Tracker `__. For + issues about the example notebooks, errors in the example codes, outdated information, improvement + suggestions... +- `PyMC3 - Issue Tracker `__. For issues, bugs or + feature requests related to the PyMC3 library itself. + +Finally, if you need to get in touch for non-technical information about the project, `send us an e-mail `__. Getting started =============== @@ -58,26 +82,6 @@ Papers citing PyMC3 See `Google Scholar `__ for a continuously updated list. -Contributors -============ - -See the `GitHub contributor -page `__. Also read our `Code of Conduct `__ guidelines for a better contributing experience. - - -Contact -======= - -We are using `discourse.pymc.io `__ as our main communication channel. You can also follow us on `Twitter @pymc_devs `__ for updates and other announcements. - -To ask a question regarding modeling or usage of PyMC3 we encourage posting to our Discourse forum under the `“Questions” Category `__. You can also suggest feature in the `“Development” Category `__. - -To report an issue, please use the following: - -- `PyMC3 Examples - Issue Tracker `__. -- `PyMC3 - Issue Tracker `__. - -Finally, if you need to get in touch for non-technical information about the project, `send us an e-mail `__. Support ======= @@ -126,4 +130,4 @@ Sponsors .. |tidelift_learn| image:: https://img.shields.io/badge/-learn%20more-2dd160.svg?color=orange&labelColor=58595b&style=flat&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABEAAAAOCAYAAADJ7fe0AAAAAXNSR0IArs4c6QAAAAlwSFlzAAAWJQAAFiUBSVIk8AAAAVlpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IlhNUCBDb3JlIDUuNC4wIj4KICAgPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4KICAgICAgPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIKICAgICAgICAgICAgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPgogICAgICAgICA8dGlmZjpPcmllbnRhdGlvbj4xPC90aWZmOk9yaWVudGF0aW9uPgogICAgICA8L3JkZjpEZXNjcmlwdGlvbj4KICAgPC9yZGY6UkRGPgo8L3g6eG1wbWV0YT4KTMInWQAAAVhJREFUKBV1kj0vBFEUhmd2sdZHh2IlGhKFQuOviEYiNlFodCqtUqPxA%2FwCjUTnDygkGoVERFQaZFlE9nreO%2BdM5u5wkifvuee892Pu3CyEcA0DeIc%2B9IwftJsR6Cko3uCjguZdjuBZhhwmYDjGrOC96WED41UtsgEdGEAPlmAfpuAbFF%2BFZLfoMfRBGzThDtLgePPwBIpdddGzOArhPHUXowbNptE2www6a%2Fm96Y3pHN7oQ1s%2B13pxt1ENaKzBFWyWzaJ%2BRO0C9Jny6VPSoKjLVbMDC5bn5OPuJF%2BBSe95PVEMuugY5AegS9fCh7BedP45hRnj8TC34QQUe9bTZyh2KgvFk2vc8GIlXyTfsvqr6bPpNgv52ynnlomZJNpB70Xhl%2Bf6Sa02p1bApEfnETwxVa%2Faj%2BW%2FFtHltmxS%2FO3krvpTtTnVgu%2F6gvHRFvG78Ef3kOe5PimJXycY74blT5R%2BAAAAAElFTkSuQmCC :target: https://tidelift.com/subscription/pkg/pypi-pymc3?utm_source=pypi-pymc3&utm_medium=referral&utm_campaign=enterprise .. |tidelift_demo| image:: https://img.shields.io/badge/-request%20a%20demo-2dd160.svg?color=orange&labelColor=58595b&style=flat&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABEAAAAOCAYAAADJ7fe0AAAAAXNSR0IArs4c6QAAAAlwSFlzAAAWJQAAFiUBSVIk8AAAAVlpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IlhNUCBDb3JlIDUuNC4wIj4KICAgPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4KICAgICAgPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIKICAgICAgICAgICAgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPgogICAgICAgICA8dGlmZjpPcmllbnRhdGlvbj4xPC90aWZmOk9yaWVudGF0aW9uPgogICAgICA8L3JkZjpEZXNjcmlwdGlvbj4KICAgPC9yZGY6UkRGPgo8L3g6eG1wbWV0YT4KTMInWQAAAVhJREFUKBV1kj0vBFEUhmd2sdZHh2IlGhKFQuOviEYiNlFodCqtUqPxA%2FwCjUTnDygkGoVERFQaZFlE9nreO%2BdM5u5wkifvuee892Pu3CyEcA0DeIc%2B9IwftJsR6Cko3uCjguZdjuBZhhwmYDjGrOC96WED41UtsgEdGEAPlmAfpuAbFF%2BFZLfoMfRBGzThDtLgePPwBIpdddGzOArhPHUXowbNptE2www6a%2Fm96Y3pHN7oQ1s%2B13pxt1ENaKzBFWyWzaJ%2BRO0C9Jny6VPSoKjLVbMDC5bn5OPuJF%2BBSe95PVEMuugY5AegS9fCh7BedP45hRnj8TC34QQUe9bTZyh2KgvFk2vc8GIlXyTfsvqr6bPpNgv52ynnlomZJNpB70Xhl%2Bf6Sa02p1bApEfnETwxVa%2Faj%2BW%2FFtHltmxS%2FO3krvpTtTnVgu%2F6gvHRFvG78Ef3kOe5PimJXycY74blT5R%2BAAAAAElFTkSuQmCC - :target: https://tidelift.com/subscription/request-a-demo?utm_source=pypi-pymc3&utm_medium=referral&utm_campaign=enterprise \ No newline at end of file + :target: https://tidelift.com/subscription/request-a-demo?utm_source=pypi-pymc3&utm_medium=referral&utm_campaign=enterprise