-
-
Notifications
You must be signed in to change notification settings - Fork 1.2k
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/Github] CONTRIBUTING.md addition #4132
Comments
sure, any improvements to the CONTRIBUTING.md would be welcome :) i don't know where we'd put it in the website, tbh |
@EskiMojo14 created a PR for a more beginner friendly contribution doc addressing all the changes mentioned here. Pls review and suggest if you want any changes. |
FWIW I don't think them having to open a new tab would deter them too much from contributing if the new tab has a more indepth guide to them getting started. But in saying that I am in no way married to the website idea, it was just a suggestion to try and centralise the contributing guidelines for the three repos and docs so they don't get desynced as easily. A good example is django's contributing guidelines.
It could potentially just sit in its own file under Introduction or Tutorials (or even it's own dropdown for contributing on the sidebar) on redux.js.org/. I am happy to do this on the core docs too if its desired, but refreshing these docs is a good middle ground too and I did see a PR has been opened. |
@riqts It was just my opinion and it's not that I am totally against the website idea, in fact centralizing all the contribution guidelines in detail for all the repos sounds great. I had a look at django's website as well looks similar to nextjs's contribution.md. |
The contributing guidelines on redux-toolkit could be made more inviting to first time users who are intimidated by OSS and contributing.
Options explored
Port over reduxjs/redux guidelines
the core repo's guidelines have a bit more flavor and could be ported over very easily to fit RTK.
unify core docs guidelines on the portal
Alternative/additionally, the "contributing" guidelines could just be made as a page on the core documentations website and the guidelines link to their similar to react's guidelines (although theirs links to the legacy site lol). This would just mean that across the three repos one guideline has to be maintained. (The page would still link to the 3 seperates repos and potentially clarify)
If PR's are welcome against this let me know, I suppose the first option is easy but if the second option is interesting I'll probs have to x-post to the actual repo receiving the change.
The text was updated successfully, but these errors were encountered: