Skip to content

Commit 03643c6

Browse files
committed
Update CONTRIBUTING.md
1 parent d0bdc0a commit 03643c6

File tree

1 file changed

+34
-7
lines changed

1 file changed

+34
-7
lines changed

CONTRIBUTING.md

+34-7
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,16 @@
11
# Contributing to the FLT Project
22

3-
Thank you for your interest in contributing to the FLT Project! This guide provides detailed instructions on how to effectively and efficiently contribute to the project.
3+
Thank you for your interest in contributing to the FLT Project!
4+
This guide provides detailed instructions on how to effectively and efficiently contribute to the project.
45

56
## Project Coordination
67

7-
The project is managed using a [GitHub project dashboard](#), which tracks tasks through various stages, from assignment to completion.
8+
The project is managed using a [GitHub project dashboard](https://github.com/orgs/ImperialCollegeLondon/projects/102), which tracks tasks through various stages, from assignment to completion.
89

910
## How to Contribute
1011

11-
Contributions to the project are made through GitHub pull requests (PRs) that correspond to specific tasks outlined in the project's issues. The following instructions detail the process for claiming and completing tasks.
12+
Contributions to the project are made through GitHub pull requests (PRs) that correspond to specific tasks outlined in the project's issues.
13+
The following instructions detail the process for claiming and completing tasks.
1214

1315
### 1. Task Identification
1416

@@ -25,23 +27,48 @@ Contributions to the project are made through GitHub pull requests (PRs) that co
2527

2628
Once you are assigned to an issue, begin working on the corresponding task. You should create a new branch from the `main` branch to develop your solution.
2729

30+
> [!WARNING]
31+
> Before pushing any changes, you have the following options:
32+
>
33+
> - You might want to install the git pre-push hook by running:
34+
>
35+
> ```bash
36+
> scripts/install_pre-push.sh
37+
> ```
38+
> This will automatically run checks before every push, reducing the risk of CI check failures.
39+
>
40+
> - You can manually run the following script before pushing, reducing the risk of CI check failures:
41+
>
42+
> ```bash
43+
> scripts/run_before_push.sh
44+
> ```
45+
> This requires manual execution and won't stop the push if skipped.
46+
>
47+
> - You may push your changes without any safeguards, increasing the risk of CI check failures.
48+
2849
### 4. Submitting a Pull Request
2950
3051
- When you are ready to submit your solution, create a PR from your working branch to the project’s `main` branch.
31-
- After submitting the PR, comment the single phrase `propose PR #PR_NUMBER` on the original issue. This links your PR to the task, and the task will move to the `In Progress` column on the dashboard.
52+
- After submitting the PR, comment `propose #PR_NUMBER` on the original issue. This links your PR to the task, and the task will move to the `In Progress` column on the dashboard.
3253
- A task can only move to `In Progress` if it has been claimed by the user proposing the PR.
3354
3455
### 5. Withdrawing or Updating a PR
3556
36-
- If you need to withdraw your PR, comment the single phrase `withdraw PR #PR_NUMBER` on the issue. The task will return to the `Claimed` column, but you will remain assigned to the issue.
37-
- To submit an updated PR after withdrawal, comment the single phrase `propose PR #NEW_PR_NUMBER` following the same process outlined in step 4.
57+
- If you need to withdraw your PR, comment the single phrase `withdraw #PR_NUMBER` on the issue. The task will return to the `Claimed` column, but you will remain assigned to the issue.
58+
- To submit an updated PR after withdrawal, comment `propose #NEW_PR_NUMBER` following the same process outlined in step 4.
3859
3960
### 6. Review Process
4061
41-
- After finishing the task and ensuring your PR is ready for review, comment the single word `awaiting-review` on the PR. This will add the `awaiting-review` label to your PR and move the task from `In Progress` to the `In Review` column of the dashboard.
62+
- After finishing the task and ensuring your PR is ready for review, comment `awaiting-review` on the PR. This will add the `awaiting-review` label to your PR and move the task from `In Progress` to the `In Review` column of the dashboard.
4263
- The project maintainers will review the PR. They may request changes, approve the PR, or provide feedback.
4364
4465
### 7. Task Completion
4566
4667
- Once the PR is approved and merged, the task will automatically move to the `Completed` column.
4768
- If further adjustments are needed after merging, a new issue will be created to track additional work.
69+
70+
### Additional Guidelines and Notes
71+
72+
1. Please adhere to the issue claiming process. If an issue is already assigned to another contributor, refrain from working on it without prior communication with the current claimant. This ensures a collaborative and respectful workflow that values each contributor’s efforts.
73+
2. Be aware that this contribution process is still in an experimental phase. As a result, occasional issues and inefficiencies may arise. We are committed to continuously refining the process, and your constructive feedback is highly appreciated. You can share your thoughts and suggestions on the [Lean Zulip chat channel](https://leanprover.zulipchat.com/#narrow/stream/416277-FLT).
74+
3. Until the integration of sufficient CI automation, the management of the project dashboard is handled manually by the maintainers. We ask for your patience and understanding as we work to keep the process running smoothly.

0 commit comments

Comments
 (0)