CONTRIBUTING.md 1.79 KB
Newer Older
1
2
# Contributing

3
That would be awesome if you want to contribute something to TileLang!
4
5
6
7
8
9
10
11
12
13

- [Contributing](CONTRIBUTING.md#contributing)
  - [Reporting Bugs](CONTRIBUTING.md#reporting-bugs)
  - [Asking Questions](CONTRIBUTING.md#asking-questions)
  - [Submitting Pull Requests](CONTRIBUTING.md#submitting-pull-requests)
  - [Repository Setup](CONTRIBUTING.md#repository-setup)
  - [Running Tests](CONTRIBUTING.md#running-tests)

## Reporting Bugs

14
If you run into any weird behavior while using TileLang, feel free to open a new issue in this repository! Please run a **search before opening** a new issue, to make sure that someone else hasn't already reported or solved the bug you've found.
15
16
17
18
19
20
21
22
23
24
25
26
27

Any issue you open must include:

- Code snippet that reproduces the bug with a minimal setup.
- A clear explanation of what the issue is.


## Asking Questions

Please ask questions in issues.

## Submitting Pull Requests

28
All pull requests are super welcomed and greatly appreciated! Issues in need of a solution are marked with a [`♥ help`](https://github.com/ianstormtaylor/TileLang/issues?q=is%3Aissue+is%3Aopen+label%3A%22%E2%99%A5+help%22) label if you're looking for somewhere to start.
29
30
31
32
33
34
35

Please run `./format.sh` before submitting a pull request to make sure that your code is formatted correctly.

Please include tests and docs with every pull request!

## Repository Setup

36
To run the build, you need to have the TileLang repository cloned to your computer. After that, you need to `cd` into the directory where you cloned it, and install the dependencies with `python`:
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

```bash
python setup.py install
```


## Running Tests

To run the tests, start by building the project as described in the [Repository Setup](CONTRIBUTING.md#repository-setup) section.

Then you can rerun the tests with:

```text
python -m pytest testing
```