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

Docs: Contribution Guide #462

Merged
merged 26 commits into from
Dec 11, 2024
Merged

Docs: Contribution Guide #462

merged 26 commits into from
Dec 11, 2024

Conversation

webecke
Copy link
Contributor

@webecke webecke commented Nov 6, 2024

Overview

This PR introduces a Contribution Guide that makes official a lot of assumed practices on the Autograder development team, and helps new developers know how to contribute.

Please give your feedback! I don't want this to be just the Dallin said so document. What needs changing? What's redundant or too much? What's missing?

Details

  • Introduces a PR template (which in theory will work once this is merged)
  • Contribution Guide gives pointers to new developers
  • Introduces commit message guidelines
  • Formalizes the PR process
  • Formalizes the issue-name-prefix practice currently in place
  • Explains how to add a person to the AboutPage
  • Says tests are required for new features
  • A bunch more, you should just go read the new CONTRIBUTING.md

Future Work

Two things come to mind as I've been working on this, which should be separate issues

Also, this branch was based on the README-improvements branch, not main, so a rebase might be required if this PR is finished before the other one

@webecke webecke added documentation Improvements or additions to documentation help wanted Extra attention is needed labels Nov 6, 2024
@webecke webecke self-assigned this Nov 6, 2024
@webecke webecke linked an issue Nov 6, 2024 that may be closed by this pull request
1 task
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Show resolved Hide resolved
docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
docs/CONTRIBUTING.md Show resolved Hide resolved
@webecke webecke force-pushed the contributing-guidlines branch 2 times, most recently from 6df4051 to 5282693 Compare November 7, 2024 15:16
@frozenfrank frozenfrank changed the base branch from main to 451-improve-readmes November 8, 2024 15:59
@frozenfrank
Copy link
Contributor

This PR has been updated to merge into the #452 (which it was based on) so that the PR diff views appear properly.

docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
@webecke
Copy link
Contributor Author

webecke commented Nov 19, 2024

I can't figure out whats going on with the diff on this PR. it should only have a few markdown files different from 451-improve-readmes, especially since I just merged main on both. But like half the files have big differences on this branch. Anyone have a clue why?

Base automatically changed from 451-improve-readmes to main November 19, 2024 17:46
@19mdavenport 19mdavenport force-pushed the contributing-guidlines branch from d8c0b24 to e3f5499 Compare November 21, 2024 17:33
- Provide details on PR dependencies
- Call out the bulleted list
In generaly, now new content was added, but links and images to
existing resources were added. In some cases, clarifying words
were added to emphasize particular points. In few cases, the
linting of the file was improved. Most of the linting issues
in this file were not touched.
This fixes and standardizes the whitespace, and indention in the file.

Not all of the automatic suggestions were taken at face value.
Plenty of them were manually reverted or manually adjusted to
better match human expectations.
Copy link
Contributor

@frozenfrank frozenfrank left a comment

Choose a reason for hiding this comment

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

Thank you for putting this together!

I made the last adjustments I felt necessary. At this point, are there any other blocking requirements to merge this PR?

- `remove unused imports`
- `refactor test runner`
- `document API endpoints`
- Use lowercase letters
Copy link
Contributor

Choose a reason for hiding this comment

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

But I like writing my commits in sentence case with the first letter capitalized. Is that an issue?

This allows an IDE to open up just that nested root folder,
and still have access to the getting started guide.
@webecke webecke merged commit e3480ea into main Dec 11, 2024
2 checks passed
@webecke webecke deleted the contributing-guidlines branch December 11, 2024 21:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation help wanted Extra attention is needed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Docs: Create CONTRIBUTING.md file
4 participants