arXiv/arxiv-browse

Add a contributing guide

zeke opened this issue ยท 4 comments

zeke commented

Is your feature request related to a problem? Please describe.

I'm a first-time contributor, part of the team at @replicate (the folks who built @arxiv-vanity). ๐Ÿ‘‹๐Ÿผ

I'm starting to work on an arXiv Labs integration and trying to get my dev env set up. I looked for a CONTRIBUTING.md at the top-level of the repo, but don't see one.

Describe the solution you'd like

I think it would be great to have a contributing guide with details about the project code of conduct, how to make contributions, how to get a development environment up and running, etc.

The existing README here could be used as a starting point for describing the development environment.

Describe alternatives you've considered

The contributing guide could also live in the README, but I think it would be preferable to keep the README short and sweet, with more of an overview of what this repo actually is/does/contains, plus links to things like the contributing guide, the org-wide contributing guide, etc.

Additional context

I'd be happy to help on this once I've got my development environment working. See #253

cc @erickpeirson @mhl10 @bdc34, because I see you three have worked on these docs in the past.

zeke commented

cc @SBBCornell and @mhl10, my arXiv Labs liaisons :)