|
| 1 | +--- |
| 2 | +editor: |
| 3 | + markdown: |
| 4 | + wrap: 72 |
| 5 | +--- |
| 6 | + |
1 | 7 | # Contributing |
2 | 8 |
|
3 | | -We welcome any input, feedback, bug reports, and contributions to the **AutoEDA** package. This project aims to be a lightweight Python package designed to automate the most common and time consuming steps of Exploratory Data Analysis (EDA). |
| 9 | +We welcome any input, feedback, bug reports, and contributions to the |
| 10 | +**AutoEDA** package. This project aims to be a lightweight Python |
| 11 | +package designed to automate the most common and time consuming steps of |
| 12 | +Exploratory Data Analysis (EDA). |
4 | 13 |
|
5 | 14 | Your contributions can help us: |
6 | 15 |
|
7 | | -- Improve functions performance and usability |
8 | | -- Incorporate additional features |
9 | | -- Refine visualizations |
10 | | -- Expand documentation |
| 16 | +- Improve functions performance and usability |
| 17 | +- Incorporate additional features |
| 18 | +- Refine visualizations |
| 19 | +- Expand documentation |
11 | 20 |
|
12 | | -All contributions, suggestions, and feedback you submit are accepted under the [Project's license](LICENSE). You represent that if you do not own copyright in the code that you have the authority to submit it under the [Project's license](LICENSE). All feedback, suggestions, or contributions are not confidential. |
| 21 | +All contributions, suggestions, and feedback you submit are accepted |
| 22 | +under the [Project's license](LICENSE). You represent that if you do not |
| 23 | +own copyright in the code that you have the authority to submit it under |
| 24 | +the [Project's license](LICENSE). All feedback, suggestions, or |
| 25 | +contributions are not confidential. |
13 | 26 |
|
14 | 27 | ## Example Contributions |
15 | 28 |
|
16 | 29 | You can contribute in many ways, for example: |
17 | 30 |
|
18 | | -- [Report bugs](#report-bugs) |
19 | | -- [Fix Bugs](#fix-bugs) |
20 | | -- [Implement Features](#implement-features) |
21 | | -- [Write Documentation](#write-documentation) |
22 | | -- [Submit Feedback](#submit-feedback) |
| 31 | +- [Report bugs](#report-bugs) |
| 32 | +- [Fix Bugs](#fix-bugs) |
| 33 | +- [Implement Features](#implement-features) |
| 34 | +- [Write Documentation](#write-documentation) |
| 35 | +- [Submit Feedback](#submit-feedback) |
23 | 36 |
|
24 | | -### Report Bugs |
| 37 | +### Report Bugs {#report-bugs} |
25 | 38 |
|
26 | | -Report bugs here -> [issues](https://github.com/Eligoze75/autoeda/issues). |
| 39 | +Report bugs here -\> |
| 40 | +[issues](https://github.com/UBC-MDS/autoeda/issues). |
27 | 41 |
|
28 | | -**If you are reporting a bug, please follow the template guidelines. The more |
29 | | -detailed your report, the easier and thus faster we can help you.** |
| 42 | +**If you are reporting a bug, please follow the template guidelines. The |
| 43 | +more detailed your report, the easier and thus faster we can help you.** |
30 | 44 |
|
31 | | -### Fix Bugs |
| 45 | +### Fix Bugs {#fix-bugs} |
32 | 46 |
|
33 | | -Look through the GitHub issues for bugs. Anything labelled with `bug` and |
34 | | -`help wanted` is open to whoever wants to implement it. When you decide to work on such an issue, please assign yourself to it and add a comment that you'll be working on that, too. If you see another issue without the `help wanted` label, just post a comment, the maintainers are usually happy for any support that they can get. |
| 47 | +Look through the GitHub issues for bugs. Anything labelled with `bug` |
| 48 | +and `help wanted` is open to whoever wants to implement it. When you |
| 49 | +decide to work on such an issue, please assign yourself to it and add a |
| 50 | +comment that you'll be working on that, too. If you see another issue |
| 51 | +without the `help wanted` label, just post a comment, the maintainers |
| 52 | +are usually happy for any support that they can get. |
35 | 53 |
|
36 | | -### Implement Features |
| 54 | +### Implement Features {#implement-features} |
37 | 55 |
|
38 | 56 | Look through the GitHub issues for features. Anything labelled with |
39 | | -`enhancement` and `help wanted` is open to whoever wants to implement it. As |
40 | | -for [fixing bugs](#fix-bugs), please assign yourself to the issue and add a comment that |
41 | | -you'll be working on that, too. If another enhancement catches your fancy, but it |
42 | | -doesn't have the `help wanted` label, just post a comment, the maintainers are usually |
43 | | -happy for any support that they can get. |
| 57 | +`enhancement` and `help wanted` is open to whoever wants to implement |
| 58 | +it. As for [fixing bugs](#fix-bugs), please assign yourself to the issue |
| 59 | +and add a comment that you'll be working on that, too. If another |
| 60 | +enhancement catches your fancy, but it doesn't have the `help wanted` |
| 61 | +label, just post a comment, the maintainers are usually happy for any |
| 62 | +support that they can get. |
44 | 63 |
|
45 | | -### Write Documentation |
| 64 | +### Write Documentation {#write-documentation} |
46 | 65 |
|
47 | | -AutoEDA could always use more documentation, whether as |
48 | | -part of the official documentation, in docstrings, or even on the web in blog |
49 | | -posts, articles, and such. Just |
50 | | -[open an issue](https://github.com/Eligoze75/autoeda/issues) |
51 | | -to let us know what you will be working on so that we can provide you with guidance. |
| 66 | +AutoEDA could always use more documentation, whether as part of the |
| 67 | +official documentation, in docstrings, or even on the web in blog posts, |
| 68 | +articles, and such. Just [open an |
| 69 | +issue](https://github.com/UBC-MDS/autoeda/issues) to let us know what |
| 70 | +you will be working on so that we can provide you with guidance. |
52 | 71 |
|
53 | | -### Submit Feedback |
| 72 | +### Submit Feedback {#submit-feedback} |
54 | 73 |
|
55 | | -The best way to send feedback is to file an issue at this link |
56 | | -[AutoEDA issues](https://github.com/Eligoze75/autoeda/issues). If your feedback fits the format of one of the issue templates, please use that. Remember that this is a volunteer-driven project and everybody has limited time. |
| 74 | +The best way to send feedback is to file an issue at this link [AutoEDA |
| 75 | +issues](https://github.com/UBC-MDS/autoeda/issues). If your feedback |
| 76 | +fits the format of one of the issue templates, please use that. Remember |
| 77 | +that this is a volunteer-driven project and everybody has limited time. |
57 | 78 |
|
58 | 79 | ## Get Started! |
59 | 80 |
|
60 | | -Ready to contribute? Here's how to set up AutoEDA for |
61 | | -local development. |
| 81 | +Ready to contribute? Here's how to set up AutoEDA for local development. |
| 82 | + |
| 83 | +1. Fork the https://github.com/UBC-MDS/autoeda repository on GitHub. |
62 | 84 |
|
63 | | -1. Fork the https://github.com/Eligoze75/autoeda repository on GitHub. |
64 | | -2. Clone your fork locally (*if you want to work locally*) |
| 85 | +2. Clone your fork locally (*if you want to work locally*) |
65 | 86 |
|
66 | | - ```shell |
| 87 | + ``` shell |
67 | 88 | git clone git@github.com:your_name_here/autoeda.git |
68 | 89 | ``` |
69 | 90 |
|
70 | | -3. [Install hatch](https://hatch.pypa.io/latest/install/). |
| 91 | +3. [Install hatch](https://hatch.pypa.io/latest/install/). |
71 | 92 |
|
72 | | -4. Create a branch for local development using the default branch (typically `main`) as a starting point. Use `fix` or `feat` as a prefix for your branch name. |
| 93 | +4. Create a branch for local development using the default branch |
| 94 | + (typically `main`) as a starting point. Use `fix` or `feat` as a |
| 95 | + prefix for your branch name. |
73 | 96 |
|
74 | | - ```shell |
| 97 | + ``` shell |
75 | 98 | git checkout main |
76 | 99 | git checkout -b fix-name-of-your-bugfix |
77 | 100 | ``` |
78 | 101 |
|
79 | 102 | Now you can make your changes locally. |
80 | 103 |
|
81 | | -5. When you're done making changes, apply the quality assurance tools and check |
82 | | - that your changes pass our test suite. This is all included with tox |
| 104 | +5. When you're done making changes, apply the quality assurance tools |
| 105 | + and check that your changes pass our test suite. This is all |
| 106 | + included with tox |
83 | 107 |
|
84 | | - ```shell |
| 108 | + ``` shell |
85 | 109 | hatch run test:run |
86 | 110 | ``` |
87 | 111 |
|
88 | | -6. Commit your changes and push your branch to GitHub. Please use [semantic |
89 | | - commit messages](https://www.conventionalcommits.org/). |
| 112 | +6. Commit your changes and push your branch to GitHub. Please use |
| 113 | + [semantic commit messages](https://www.conventionalcommits.org/). |
90 | 114 |
|
91 | | - ```shell |
| 115 | + ``` shell |
92 | 116 | git add . |
93 | 117 | git commit -m "fix: summarize your changes" |
94 | 118 | git push -u origin fix-name-of-your-bugfix |
95 | 119 | ``` |
96 | 120 |
|
97 | | -7. Open the link displayed in the message when pushing your new branch in order |
98 | | - to submit a pull request. |
| 121 | +7. Open the link displayed in the message when pushing your new branch |
| 122 | + in order to submit a pull request. |
99 | 123 |
|
100 | 124 | ### Testing Your Changes |
101 | 125 |
|
102 | 126 | Before submitting your changes, ensure that: |
103 | 127 |
|
104 | | -1. **Your code runs without errors**: Test all modified modules and functions |
105 | | -2. **Dependencies are documented**: Update `requirements.txt` if you add new packages (TBC) |
| 128 | +1. **Your code runs without errors**: Test all modified modules and |
| 129 | + functions |
| 130 | +2. **Dependencies are documented**: Update `requirements.txt` if you |
| 131 | + add new packages (TBC) |
106 | 132 |
|
107 | 133 | ### Creating a Pull Request |
108 | 134 |
|
109 | | -Provide a clear title and detailed description of your changes: - What problem does it solve? - What are the key results or improvements? - Are there any limitations or concerns? |
| 135 | +Provide a clear title and detailed description of your changes: - What |
| 136 | +problem does it solve? - What are the key results or improvements? - Are |
| 137 | +there any limitations or concerns? |
110 | 138 |
|
111 | | -Your PR will be reviewed, and you may receive feedback or requests for changes. |
| 139 | +Your PR will be reviewed, and you may receive feedback or requests for |
| 140 | +changes. |
112 | 141 |
|
113 | 142 | ## Code of Conduct |
114 | 143 |
|
115 | | -We are committed to providing a welcoming and inclusive environment for all contributors. We expect all participants to: |
| 144 | +We are committed to providing a welcoming and inclusive environment for |
| 145 | +all contributors. We expect all participants to: |
116 | 146 |
|
117 | | -- Be respectful and considerate in communications |
118 | | -- Welcome newcomers and help them get started |
119 | | -- Accept constructive criticism gracefully |
| 147 | +- Be respectful and considerate in communications |
| 148 | +- Welcome newcomers and help them get started |
| 149 | +- Accept constructive criticism gracefully |
120 | 150 |
|
121 | 151 | ## Questions and Discussions |
122 | 152 |
|
123 | 153 | If you have questions or want to discuss ideas before contributing: |
124 | 154 |
|
125 | | -- Open an issue with the `question` or `discussion` label |
126 | | -- Reach out to the maintainers |
127 | | -- Share your ideas and get feedback before investing significant time |
| 155 | +- Open an issue with the `question` or `discussion` label |
| 156 | +- Reach out to the maintainers |
| 157 | +- Share your ideas and get feedback before investing significant time |
128 | 158 |
|
129 | 159 | ## Acknowledgments |
130 | 160 |
|
131 | | -Thank you for your interest in contributing to **AutoEDA**. Every suggestion, bug report, or enhancement no matter how small helps improve the quality, usability, and reliability of this package. |
| 161 | +Thank you for your interest in contributing to **AutoEDA**. Every |
| 162 | +suggestion, bug report, or enhancement no matter how small helps improve |
| 163 | +the quality, usability, and reliability of this package. |
132 | 164 |
|
133 | | -By contributing, you are helping make exploratory data analysis more accessible, nicer, and less time consuming for data scientists and analysts. Together, we can build better tools that support clearer insights and stronger data driven decisions. |
| 165 | +By contributing, you are helping make exploratory data analysis more |
| 166 | +accessible, nicer, and less time consuming for data scientists and |
| 167 | +analysts. Together, we can build better tools that support clearer |
| 168 | +insights and stronger data driven decisions. |
134 | 169 |
|
135 | 170 | We truly appreciate your time and effort in supporting this project. |
136 | 171 |
|
137 | 172 | ------------------------------------------------------------------------ |
138 | 173 |
|
139 | | -*This document was inspired by the [Altair CONTRIBUTING.md](https://github.com/vega/altair/blob/main/CONTRIBUTING.md) and adapted for the Sepsis Survival Prediction Project.* |
| 174 | +*This document was inspired by the [Altair |
| 175 | +CONTRIBUTING.md](https://github.com/vega/altair/blob/main/CONTRIBUTING.md) |
| 176 | +and adapted for the autoeda project* |
0 commit comments