Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation for contributing to Aesara #1283

Merged
merged 1 commit into from
Nov 10, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 39 additions & 26 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,42 @@
If you want to contribute to Aesara, have a look at the instructions here:
https://aesara.readthedocs.io/en/latest/dev_start_guide.html


## Migrating PRs from the original Theano Repo
Aesara is actively merging new changes. If you have a pull request on the original Theano repository and would like to move it here use the following commands in your local Aesara repository:

```
# Go to your Aesara repo
cd /path/to/your/repo

# If you'd like to add aesara as a remote
git remote add aesara [email protected]:aesara-devs/aesara.git

# Verify the changes. You should see the aesara-devs/aesara.git
git remote -v

# Checkout the branch of your request
git checkout branch_name

# Push to Aesara
git push aesara branch_name
```

If you would like to make Aesara the new "main" upstream remote:

```
git remote set-url upstream [email protected]:aesara-devs/aesara.git
```
## Contribution Expectations

This "Contribution Expectations" section is adapted from [Open Source
Archetypes](https://opentechstrategies.com/archetypes) and released under a
[CC-BY-SA](https://creativecommons.org/licenses/by-sa/4.0/) license.

The current focus of the Aesara project is rapid, high quality development of a
hackable, pure-Python symbolic tensor library with strong support for graph
rewrites and transpilation to multiple backends including C,
[JAX](https://github.com/google/jax>), and
[Numba](https://github.com/numba/numba).

We welcome patches with bug fixes, and we’re happy to answer questions if you’ve
already put in some effort to find the answer yourself. Please note, however,
that we’re _unlikely_ to consider new feature contributions or design changes
unless there’s a strong argument that they are fully in line with our stated
goals. If you’re not sure, just ask.

Our technical scope and project governance may open up later, of course, For
now, though, we would characterize this project as being a mix of the "Rocket
Ship To Mars" and "Specialty Library" archetypes (see
https://opentechstrategies.com/archetypes for details about RStM and other open
source archetypes).

## Issues and Discussions

We expect that Github Issues ("issues") indicate work that should be in Aesara
and can be picked up immediately by a contributor. This includes bugs, which
indicate something not working as advertised.

Discussions should be created when the scope or direction of the work, though
within the stated goals of the Aesara project, require additional clarification
or consideration before a course of action is chosen.

For issues a minimal working example (MWE) is strongly recommended when relevant
(fixing a typo in the documentation does not require a MWE). For discussions,
MWEs are generally required. All MWEs must be implemented using Aesara. Please
do not submit MWEs if they are not implemented in Aesara. In certain cases,
pseudocode may be acceptable, but an Aesara implementation is always preferable.
10 changes: 10 additions & 0 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,16 @@ The current development branch of |Project Name| can be installed from GitHub, a
pip install git+https://github.com/aesara-devs/aesara


Contributing
============

We welcome bug reports and fixes and improvements to the documentation.

For more information on contributing, please see the
`contributing guide <https://github.com/aesara-devs/aesara/CONTRIBUTING.md>`.

A good place to start contributing is by looking through the issues
`here <https://github.com/aesara-devs/aesara/issues`.

Support
=======
Expand Down