search

jspsych / experiment-demos

MIT License
2 stars 8 forks source link

Contributing Guide #11

Open jodeleeuw opened 3 years ago

jodeleeuw commented 3 years ago

There's been a fair amount of healthy discussion about what a new contribution to this repo should look like. This makes me think that a contribution guide, beyond what's currently in the readme would be useful. Specifically, I think the guide should cover:

Creating this doc will also help the early contributors to this repo hash out some of these guiding principles and settle on a common understanding of what we are trying to do.

pjkohler commented 3 years ago

I am happy to contribute. Where would the guide live? I am thinking we would not want to have it on the front page, as it is already becoming quite dense. We might have separate subfolders devoted to contributing an experiment and collecting data using an experiment, that we link to from the front page.

jodeleeuw commented 3 years ago

I think a contributing.md file in the root directory is pretty standard practice for GitHub. Some GH docs.

We could also turn on GitHub pages for this repo and make a very small /docs directory that would be served as a website.

pjkohler commented 3 years ago

nice, okay. Why don't we start with a contributing.md file and then we can consider turning on Github pages later? I use Github pages for my lab website and am really happy with it, but not an expert by any means.

jodeleeuw commented 3 years ago

sounds good!

pjkohler commented 3 years ago

I have added some files and updated the Readme. Very far from @jodeleeuw's notion of scope and so on, but it is a start. I would like to know how a pull request should work. I am doing one with Jason shortly, but not if our procedure is 100% the one we want to follow.