Navigation Menu

Skip to content
This repository has been archived by the owner on Nov 3, 2023. It is now read-only.

[Doc Day] Contribution Guide #3047

Merged
merged 4 commits into from Sep 3, 2020
Merged

[Doc Day] Contribution Guide #3047

merged 4 commits into from Sep 3, 2020

Conversation

spencerp
Copy link
Contributor

@spencerp spencerp commented Sep 2, 2020

Patch description
Adding some instructions for creating a pull request, in an attempt to make new contributors feel more comfortable submitting a PR.

I may have plagiarized a couple things from https://pytorch.org/docs/stable/community/contribution_guide.html

Also slipped in an unrelated typo fix.

Testing steps

make html

Screen Shot 2020-09-02 at 6 09 50 PM

Logs
n/a

Other information
none

Data tests (if applicable)
n/a

@@ -1,4 +1,4 @@
# Advance Scripts
# Advanced Scripts
Copy link
Contributor

Choose a reason for hiding this comment

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

thanks for catching this

Contributing
------------

ParlAI is maintained by a small team at Facebook, so we rely heavily on community contributions. We welcome pull requests with open wings!
Copy link
Contributor

Choose a reason for hiding this comment

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

interestingly, I'm not sure if we ever mention that we're a team at Facebook explicitly, though I suppose the url github.com/facebookresearch/ParlAI gives it away

Copy link
Contributor Author

Choose a reason for hiding this comment

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

If we'd prefer to not put ourselves in a box, I could change this to "ParlAI is maintained by a small team, ..."

Copy link
Contributor

Choose a reason for hiding this comment

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

works for me! also more the truth, as we've had major contributors who never worked at Facebook

#### Creating a Pull Request

##### Selecting reviewers
There’s no master gatekeeper for ParlAI, so don’t worry about needing to add any particular person. Just take a look at the blame for the file you’re modifying and try to find someone who has made a significant and recent change to that code. Also, add people about who might be affected by your change.
Copy link
Contributor

Choose a reason for hiding this comment

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

nit: "Also, add people who might be affected..." (extraneous "about")

- Iterate with reviewers, fix CI, add tests
- Celebrate!

#### Creating a Pull Request
Copy link
Contributor

Choose a reason for hiding this comment

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

Based on the left side TOC, I suggest making all of them ###

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I fixed them to be consistent. I see that #### is a little over-indented. But if I make them ### they are almost the same size as the section header "Contributing" :/

Let me know if you feel strongly and I'll switch them to ###

@spencerp spencerp merged commit 888722c into master Sep 3, 2020
@spencerp spencerp deleted the contribution-doc branch September 3, 2020 12:48
@stephenroller stephenroller mentioned this pull request Sep 5, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants