Skip to content

Add contribution guide and code of conduct #13

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

Merged
merged 12 commits into from
Nov 8, 2022
Merged

Conversation

dondonz
Copy link
Collaborator

@dondonz dondonz commented Oct 23, 2022

This PR

  • Adds a contribution guide and explains the PR review process. This website information is mirrored in the CONTRIBUTING.md file in case a contributor finds the GitHub repo first
  • Moves contribution information from the implementation guide into a separate document
  • Adds explanation on immutable specifications, except for minor non-semantic changes. Add versioning explanation.
  • Adds a code of conduct (copied from graphql-java)
  • Adds explanation of the Contributor License Agreement (copied from graphql-wg)

After merging this PR, the remaining two items are: deciding on license and connecting to the GraphQL Foundation domain.

@@ -166,30 +166,3 @@ values for logically identical values. For example a `MyLocalDate` scalar could
accept the literals `"01-10-2022"` and `"01102022"` as input for the first of
October 2022, but the result coercion should always return one of the possible
representations.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Moved to template

This was referenced Oct 23, 2022
@dondonz dondonz requested a review from andimarek October 23, 2022 06:42
@@ -0,0 +1,49 @@
# Contributor Code of Conduct
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think we should reference here the general GraphQL code of conduct and not introduce a new one.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Good idea, I'll reference https://graphql.org/codeofconduct/

@@ -2,7 +2,7 @@

"Author: andimarek"

"Date: 18.10.2022"
"Date: 2022.10.18"
Copy link
Collaborator

Choose a reason for hiding this comment

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

How about yyyy-mm-dd instead of .?

should be under "scalars/contributed/<your-name>/<scalar-name>.md"
The goal of the GraphQL Scalars project is to provide a directory of GraphQL
Custom Scalar specifications, contributed by the community. Contributed
specifications will be hosted on a GraphQL Foundation owned domain, which can be
Copy link
Collaborator

Choose a reason for hiding this comment

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

We should be specific and name the domain scalars.graphql.org

available reference documents. We will permit small edits which do not change
specification semantics, such as typo fixes.

A new version of a Custom Scalar specification should have a new scalar name,
Copy link
Collaborator

Choose a reason for hiding this comment

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

or just a completely different name like OffsetDateTime vs DateTime

@dondonz dondonz merged commit be1476d into main Nov 8, 2022
@dondonz dondonz deleted the contribution-guidelines branch November 8, 2022 23:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants