Skip to content

improve doc for new contributors#586

Merged
antoyo merged 7 commits intorust-lang:masterfrom
g4titanx:contributing
Apr 29, 2025
Merged

improve doc for new contributors#586
antoyo merged 7 commits intorust-lang:masterfrom
g4titanx:contributing

Conversation

@g4titanx
Copy link
Copy Markdown
Contributor

@g4titanx g4titanx commented Jan 3, 2025

this PR fixes issue #562

@g4titanx
Copy link
Copy Markdown
Contributor Author

g4titanx commented Jan 3, 2025

@antoyo

@g4titanx
Copy link
Copy Markdown
Contributor Author

g4titanx commented Jan 8, 2025

@antoyo waiting on a review for this too

@antoyo
Copy link
Copy Markdown
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
Copy Markdown
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.

Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
@antoyo
Copy link
Copy Markdown
Contributor

antoyo commented Feb 8, 2025

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

@g4titanx
Copy link
Copy Markdown
Contributor Author

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

done, sorry for the delay.

Copy link
Copy Markdown
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.

Comment thread CONTRIBUTING.md
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread Readme.md Outdated
Comment thread Readme.md Outdated
Comment thread CONTRIBUTING.md

- 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
Copy Markdown
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?

Comment thread CONTRIBUTING.md
### Common Development Tasks

#### Running Specific Tests
To run specific tests, use appropriate flags such as:
Copy link
Copy Markdown
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.

Comment thread CONTRIBUTING.md
```

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

Choose a reason for hiding this comment

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

Same here.

Comment thread CONTRIBUTING.md
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
Copy Markdown
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 thread CONTRIBUTING.md
- `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
Copy Markdown
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 thread CONTRIBUTING.md
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
Copy Markdown
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
Copy Markdown
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
Copy Markdown
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