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

[MRG] updated the docs of contributing #175

Merged
merged 1 commit into from
Sep 5, 2024
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
79 changes: 73 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,75 @@
## Contributing
# Contributing to MLE Agent

We welcome contributions from the community. We are looking for contributors to help us with the following tasks:
This document is a work in progress. If you notice areas for improvement, please feel free to update this guide and submit a pull request!

- Benchmark and Evaluate the agent
- Add more features to the agent
- Improve the documentation
- Write tests
## Table of Contents

- [Submitting a Pull Request](#submitting-a-pull-request)
- [Ensuring Your Pull Request Gets Accepted](#ensuring-your-pull-request-gets-accepted)
- [The Review Process](#the-review-process)
- [Work in Progress Pull Requests](#work-in-progress-pull-requests)
- [Triaging Issues](#triaging-issues)

## Submitting a Pull Request

To contribute code to MLE Agent, you need to open a [pull request](https://help.github.com/articles/about-pull-requests/). The pull request will be reviewed by the community before it is merged into the core project. Generally, a pull request should be submitted when a unit of work is complete, but you can also share ideas or get feedback through a work in progress (WIP) pull request ([learn more](#work-in-progress-pull-requests)).

1. Familiarize yourself with the project by reading our ["Getting Started Guide"](docs/GETTING_STARTED.md).

2. Follow our [coding standards](docs/CODE_GUIDELINES.md) to ensure consistency across the project.

3. Review our [testing guidelines](docs/TEST_GUIDELINES.md) to understand the project's automated testing framework.

4. [Set up your development environment](docs/DEVELOPMENT_SETUP.md) to make sure you have everything you need to contribute.

5. Make sure you have the latest version of the code by syncing your fork with the main repository:

```sh
git remote add upstream https://github.com/MLSysOps/MLE-agent.git
git fetch upstream
git merge upstream/main
```

6. Create a branch for the code you will be working on:

```sh
git checkout -b my-new-feature
```

7. Write your code, making sure to include tests as needed.

8. Commit your changes with a meaningful commit message:

```sh
git commit -m "Description of the changes"
```

9. Push your changes to your fork:

```sh
git push origin my-new-feature
```

10. Open a pull request on GitHub. Make sure to include a detailed description of the changes you made and any relevant context.

## Ensuring Your Pull Request Gets Accepted

- Make sure your code follows the coding standards outlined in our code guidelines -- we use [flake8](https://flake8.pycqa.org/en/latest/) to enforce these standards.
- Write tests for any new features or significant changes.
- Ensure all tests pass before submitting your pull request.
- Be responsive to feedback from reviewers.


## The Review Process

Once you submit a pull request, it will be reviewed by the maintainers. They might request changes or provide feedback. The goal is to ensure the code is high quality and aligns with the project's goals.

## Work in Progress Pull Requests

If you want feedback on your work before it's complete, you can open a WIP pull request. This allows you to get input from others on your approach or on specific parts of your code.
When you're ready for a full review, you can mark the pull request as `MRG` for review by removing the `WIP` label.

## Triaging Issues
If you're not ready to submit code but still want to contribute, you can help by triaging issues. This involves confirming bugs, providing additional information, or suggesting ways to reproduce issues.

Thank you for your interest in contributing to MLE Agent!
2 changes: 0 additions & 2 deletions mle/workflow/report.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,10 @@
Report Mode: the mode to generate the AI report based on the user's requirements.
"""
import os
import json
import pickle
import questionary
from rich.console import Console
from mle.model import load_model
from mle.utils import print_in_box
from mle.agents import SummaryAgent, ReportAgent
from mle.utils.system import get_config, write_config, check_config
from mle.integration import GoogleCalendarIntegration
Expand Down
Loading