add CONTRIBUTING.md and COLLABORATOR_GUIDE.md

[alubbe]

Here is my suggestion as to what our policies could look like. They have been heavily influenced by io.js https://github.com/nodejs/io.js/blob/master/COLLABORATOR_GUIDE.md and https://github.com/nodejs/io.js/blob/master/CONTRIBUTING.md. I expanded them with @ForbesLindesay comments: #1951 (comment) and #1956 (comment)

Differences (very much open to discussion):

• Asking for feedback to the changelog via an issue
• Raising the feedback cycle from 24 to 48h and 72h over weekends

That should be all - looking forward to some feedback!

[rlidwka]

Can it be in CONTRIBUTING.md as well? It's not a great idea to have a bunch of UPPERCASE files in the root of the project.

[alubbe]

I'm indifferent. I assume io.js did this to keep the files shorter.

[rlidwka]

Well there is a talk in io.js about moving those files into separate directory (or a separate repository even). Relevant discussion is here: nodejs/node#12

[ForbesLindesay]

I wonder if we should move the collaborator guide somewhere else entirely (perhaps a page on the website) and then just point new collaborators at this guide, since it's not relevant to most contributors.

[alubbe]

I prefer having it in the repo because it increases its visibility. For example, when other devs evaluate using jade, they can see our process - and hopefully they like what they see ;)
We could always extract it into static site at a later point in time.
@rlidwka would you be ok with leaving it in a separate file for now?

[rlidwka]

would you be ok with leaving it in a separate file for now?

yes, it doesn't matter that much

[ForbesLindesay]

This all looks like a great start. One thing I'm slightly wary of is that a lot of this will change with the 2.0.0 release, because features will be split across multiple repositories.

[alubbe]

I will work in the feedback in the coming days.
@ForbesLindesay let's land the PR before 2.0.0 - it's bigger than the release process.
I'll open a second PR afterwards where we can introduce how to release the new jade and where to open PRs for what features.

[alubbe]

Okay, so here is round 2 of the proposal - let me know what you think.

[rollingversions]

There is no change log for this pull request yet.

Create a changelog