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

Add CONTRIBUTING.md and STYLEGUIDE.md #6340

Open
wants to merge 44 commits into
base: upcoming
Choose a base branch
from

Conversation

pkmnsnfrn
Copy link
Collaborator

Description

  • Added CONTRIBUTING.md, which instructs users on how to contribute pull requests, bug reports, and feature requests to expansion.
  • Changed all templates for issues and pull requests to reflect the existence of CONTRIBUTING.md
  • Added STYLEGUIDE.md to codify our existing "rules"
  • Added docs/team_procedures/merge_checklist.md to help maintainers remember what should be done before merging a PR

People who collaborated with me in this PR

@Pawkkie, @garakmon

Discord contact info

pkmnsnfrn

There is a discussion thread.

@pkmnsnfrn pkmnsnfrn added the type: documentation Improvements or additions to documentation label Feb 25, 2025
CONTRIBUTING.md Outdated
#### 3. Create a new branch
This will create a new branch and switch to it.
```bash
git checkout -b newFeature # the name newFeature can be anything you want. This tutorial assumes you used newFeature.
Copy link
Collaborator

Choose a reason for hiding this comment

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

git switch -c newFeature also works

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Is there a difference / should I change it? legitimately asking

Copy link
Collaborator

Choose a reason for hiding this comment

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

I don't think it's a functional difference.
But git switch only handles switching branches, while checkout does much more stuff. I prefer to use switch for branch switching.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

prefixed with `s`.

```c
extern int gMyGlobalVariable;
Copy link
Collaborator

Choose a reason for hiding this comment

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

Should it use s32?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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


### Comments

Ideally, contributions have descriptive variable, function and constant names so as to explain functionality without comments. When a comment is used, the content of the comment dhould explain _WHY_ a specific system or component works the way it does.

Choose a reason for hiding this comment

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

dhould should be should

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

if (bar)
foo++;

return foo; // incorrect

Choose a reason for hiding this comment

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

Wouldn't this be correct?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type: documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants