Skip to content
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

Add Twirp Design Principles to the Contributing Guidelines and archive protocol v6 #237

Merged
merged 7 commits into from
Jun 9, 2020

Conversation

marioizquierdo
Copy link
Contributor

Add a list of Twirp Principles to the CONTRIBUTING document, to clarify what are the priorities for the project. Include examples of contributions that are welcome, and examples of contributions that will be difficult. Also update the instructions to run tests and organize the document a little better.

Archive the draft proposition for Twirp v6. Keep a document of the intended changes, to acknowledge those who may have waited for this to happen. Make it clear that v6 is not going to happen.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

CONTRIBUTING.md Outdated
Install them however you feel.
* Security updates.
* Performance improvements.
* Supporting new versions of Golang and Protobug.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
* Supporting new versions of Golang and Protobug.
* Supporting new versions of Golang and Protobuf.

CONTRIBUTING.md Outdated

## Developer Loop ##
In the other hand, contributions that contradict the following priorities will be more difficult:
Copy link
Contributor

@ofpiyush ofpiyush May 22, 2020

Choose a reason for hiding this comment

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

Suggested change
In the other hand, contributions that contradict the following priorities will be more difficult:
On the other hand, contributions that contradict the following priorities will be more difficult:

CONTRIBUTING.md Outdated
Most tests of the Go server are in `internal/twirptest/service_test.go`. Tests
of cross-language clients are in the [clientcompat](./clientcompat) directory.
* Twirp officially supports the last 3 releases of Go.
* The Python implementation uses Python 2.7.
Copy link
Contributor

Choose a reason for hiding this comment

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

Python has stopped official support for 2.7, maybe remove the requirement?

python/devguide#344

Copy link
Contributor Author

Choose a reason for hiding this comment

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

That is right. However this should be discussed in a different PR. The Python implementation has a few things that should be discussed all together. This PR adds some edits to the Contributing Guidelines, but with the focus on adding the Twirp Principles.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

We edited this point with: "As such, it is not suitable for production use in its current form.". Thanks for the reference.

@marioizquierdo marioizquierdo changed the title Update Contributing guidelines and archive v6 Add Twirp Design Principles to the Contributing Guidelines and archive protocol v6 May 24, 2020
@marioizquierdo marioizquierdo merged commit c7c0b91 into master Jun 9, 2020
@marioizquierdo marioizquierdo deleted the contributing_guidelines branch June 9, 2020 18:29
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