Skip to content

improve doc for new contributors #586

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

Merged
merged 7 commits into from
Apr 29, 2025
Merged

Conversation

g4titanx
Copy link
Contributor

@g4titanx g4titanx commented Jan 3, 2025

this PR fixes issue #562

@g4titanx
Copy link
Contributor Author

g4titanx commented Jan 3, 2025

@antoyo

@g4titanx
Copy link
Contributor Author

g4titanx commented Jan 8, 2025

@antoyo waiting on a review for this too

@antoyo
Copy link
Contributor

antoyo commented Jan 8, 2025

It might take a few more days before I can get to review this.
Sorry for the delay.

@g4titanx g4titanx mentioned this pull request Feb 6, 2025
Copy link
Contributor

@antoyo antoyo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice job.
Here's a few suggestions for improvement.

@antoyo
Copy link
Contributor

antoyo commented Feb 8, 2025

There's a conflict, so please rebase on the master branch and resolve the conflict.

@g4titanx
Copy link
Contributor Author

There's a conflict, so please rebase on the master branch and resolve the conflict.

done, sorry for the delay.

Copy link
Contributor

@antoyo antoyo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few nitpicks, but this looks very good. Thanks!
Sorry for the delay: I've been very busy lately.


- Matrix: Join our [Matrix channel](https://matrix.to/#/#rustc_codegen_gcc:matrix.org)
- IRC: Join us on [IRC](https://web.libera.chat/#rustc_codegen_gcc)
- GitHub Issues: For bug reports and feature discussions
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe add a link to github issues?

### Common Development Tasks

#### Running Specific Tests
To run specific tests, use appropriate flags such as:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For coherency with the rest, please add an empty line before and after this one.

```

#### Debugging Tools
The project provides several environment variables for debugging:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here.

The project provides several environment variables for debugging:
- `CG_GCCJIT_DUMP_GIMPLE`: Dump the GIMPLE IR
- `CG_RUSTFLAGS`: Additional Rust flags
- `CG_GCCJIT_DUMP_MODULE`: Dumps a specific module
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Before you used Dump, which is not the same verb form.

- `CG_GCCJIT_DUMP_GIMPLE`: Dump the GIMPLE IR
- `CG_RUSTFLAGS`: Additional Rust flags
- `CG_GCCJIT_DUMP_MODULE`: Dumps a specific module
- `CG_GCCJIT_DUMP_TO_FILE`: Creates C-like representation
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Before you used Dump, which is not the same verb form.

Comment on lines +62 to +63
1. Fork the repository and create a new branch
2. Make your changes with clear commit messages
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are 1. and 2. really necessary to specify?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess it doesn't hurt to keep this.

@antoyo antoyo merged commit 6d8fffe into rust-lang:master Apr 29, 2025
37 checks passed
@antoyo
Copy link
Contributor

antoyo commented Apr 29, 2025

Thanks @g4titanx for your contribution!

@GuillaumeGomez GuillaumeGomez mentioned this pull request Apr 30, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants