From e2cae0bf1ee91681dd19ed0ea5ff69ac39ec56dc Mon Sep 17 00:00:00 2001 From: Yeo Hui Fang <35210495+HuifangYeo@users.noreply.github.com> Date: Fri, 18 Nov 2022 00:54:00 +0800 Subject: [PATCH] Update contributing note to mention forking of repository. (#384) * Update contributing note to mention forking of repository. * Update CONTRIBUTING.md * Update CONTRIBUTING.md Co-authored-by: Hetal Kapadia <83311196+printhellohetal@users.noreply.github.com> --- CONTRIBUTING.md | 40 ++++++++++++++++++++++++++----------- assets/fork_atoti_repo.png | Bin 0 -> 50388 bytes 2 files changed, 28 insertions(+), 12 deletions(-) create mode 100644 assets/fork_atoti_repo.png diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 41406f92..887584e6 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,4 +1,29 @@ -We welcome any contributions from the community. Please make sure your PR follows the rules below: +We welcome any contributions from the community. + +## Getting started + +To get started, please proceed to + +1. [Fork](https://docs.github.com/en/get-started/quickstart/fork-a-repo) the atoti repository: + + + +2. Pull the `main` branch (`git checkout main` and `git pull`) from the forked repository. +3. Run `poetry install` to be sure to work with the expected dependencies. +4. Create a working branch `git switch -c /`. +5. Start JupyterLab: `poetry run jupyter lab`. +6. Create the folder and notebooks. + Add notebooks responsible for data pre-processing to the [list of untested notebooks](tests/execute_notebooks.py). + The main notebook using atoti should be tested to ensure users can run it. +7. If a dependency is missing run `poetry add `: **DEPENDENCIES MUST NOT BEEN ADDED WITH CONDA OR PIP** since the Github CI relies on the `poetry.lock` file to install dependencies. +8. Commit and push changes to the forked repository using `git push`. +9. Create a [pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) from the forked repository. + +Please monitor the pull request as each pull request is subject to automatic code testing. The atoti team will review and comment on any pull requests to ensure each submission is aligned with the API's usage. + + +## Pull Request Rules +Please make sure your PR follows the rules below: ### General notebook rules @@ -13,6 +38,7 @@ We welcome any contributions from the community. Please make sure your PR follow - entrypoint should be named `main.ipynb` - README TOC should be updated to link to the new notebook - notebook should have an H1 title, matching folder name and README TOC +- create a README at notebook level to briefly introduce yourself and the use case. ### Data rules @@ -51,17 +77,7 @@ These commands can be used while developing: poetry run python tests/execute_notebooks.py ``` -### How to write a notebook - -1. Pull the `master` branch (`git checkout master` and `git pull`). -2. Run `poetry install` to be sure to work with the expected dependencies. -3. Create the working branch `git switch -c /`. -4. Start JupyterLab `poetry run jupyter lab`. -5. Create the folder and notebooks. - Add notebooks responsible for data pre-processing to the list of untested notebooks. - The main notebook using atoti should be tested to ensure users can run them. -6. If a dependency is missing run `poetry add `: **DEPENDENCIES MUST NOT BEEN ADDED WITH CONDA OR PIP** since the Github CI is relying on the `poetry.lock` file to install dependencies. -7. Push changes using `git push` and create the related pull request. + ### About diff --git a/assets/fork_atoti_repo.png b/assets/fork_atoti_repo.png new file mode 100644 index 0000000000000000000000000000000000000000..955d23dc527fbb47aaaa833cd936e11d9832f0ab GIT binary patch literal 50388 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 literal 0 HcmV?d00001