Skip to content

Commit 2f1eccf

Browse files
committed
Merge develop into pages and remove generated site files
2 parents bbcb58e + e22b6d8 commit 2f1eccf

7 files changed

Lines changed: 382 additions & 242 deletions

File tree

.github/workflows/docs-preview.yml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,7 @@ jobs:
3333
quartodoc build
3434
3535
- name: Render Quarto Project
36-
run: |
37-
quarto render
36+
uses: quarto-dev/quarto-actions/render@v2
3837

3938
# =====================================================
4039
# Deploy to Netlify

CONTRIBUTING.md

Lines changed: 100 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -1,139 +1,176 @@
1+
---
2+
editor:
3+
markdown:
4+
wrap: 72
5+
---
6+
17
# Contributing
28

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).
413

514
Your contributions can help us:
615

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
1120

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.
1326

1427
## Example Contributions
1528

1629
You can contribute in many ways, for example:
1730

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)
2336

24-
### Report Bugs
37+
### Report Bugs {#report-bugs}
2538

26-
Report bugs here -> [issues](https://github.com/Eligoze75/autoeda/issues).
39+
Report bugs here -\>
40+
[issues](https://github.com/UBC-MDS/autoeda/issues).
2741

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.**
3044

31-
### Fix Bugs
45+
### Fix Bugs {#fix-bugs}
3246

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.
3553

36-
### Implement Features
54+
### Implement Features {#implement-features}
3755

3856
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.
4463

45-
### Write Documentation
64+
### Write Documentation {#write-documentation}
4665

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.
5271

53-
### Submit Feedback
72+
### Submit Feedback {#submit-feedback}
5473

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.
5778

5879
## Get Started!
5980

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.
6284

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*)
6586

66-
```shell
87+
``` shell
6788
git clone git@github.com:your_name_here/autoeda.git
6889
```
6990

70-
3. [Install hatch](https://hatch.pypa.io/latest/install/).
91+
3. [Install hatch](https://hatch.pypa.io/latest/install/).
7192

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.
7396

74-
```shell
97+
``` shell
7598
git checkout main
7699
git checkout -b fix-name-of-your-bugfix
77100
```
78101

79102
Now you can make your changes locally.
80103

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
83107
84-
```shell
108+
``` shell
85109
hatch run test:run
86110
```
87111
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/).
90114
91-
```shell
115+
``` shell
92116
git add .
93117
git commit -m "fix: summarize your changes"
94118
git push -u origin fix-name-of-your-bugfix
95119
```
96120
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.
99123
100124
### Testing Your Changes
101125
102126
Before submitting your changes, ensure that:
103127
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)
106132
107133
### Creating a Pull Request
108134
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?
110138
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.
112141
113142
## Code of Conduct
114143
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:
116146
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
120150
121151
## Questions and Discussions
122152
123153
If you have questions or want to discuss ideas before contributing:
124154
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
128158
129159
## Acknowledgments
130160
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.
132164
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.
134169
135170
We truly appreciate your time and effort in supporting this project.
136171
137172
------------------------------------------------------------------------
138173
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*

_quarto.yml

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,28 @@ metadata-files:
55
- reference/_sidebar.yml
66

77
website:
8-
navbar:
8+
navbar:
99
background: primary
1010
search: true
1111
left:
1212
- text: "Home"
13-
href: index.qmd
13+
href: docs/index.qmd
1414
- text: "Documentation"
1515
href: reference/index.qmd
1616

17+
18+
sidebar:
19+
contents:
20+
- text: Home
21+
file: docs/index.qmd
22+
- text: API Reference
23+
file: reference/index.qmd
24+
- text: Contributing
25+
file: docs/contributing.qmd
26+
- text: License
27+
file: docs/license.qmd
28+
29+
1730
format:
1831
html:
1932
css:

docs/contributing.qmd

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Contributing
2+
3+
We welcome contributions to **AutoEDA**, including bug reports, feature requests, documentation improvements, and code contributions.
4+
5+
## How to Contribute
6+
7+
- Open an issue to report bugs or suggest features
8+
- Fork the repository and create a feature branch
9+
- Submit a pull request with a clear description
10+
11+
For full contribution guidelines, see:
12+
13+
<https://github.com/UBC-MDS/autoeda/blob/develop/CONTRIBUTING.md>

0 commit comments

Comments
 (0)