-
Notifications
You must be signed in to change notification settings - Fork 2.3k
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
Added additonal information for installation and usage to make setup … #347
Conversation
Since 1.8, GOPATH env var is not required. golang/go#17262 . A backward compatible alternative is |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
looking great! Can you sign the google CLA?
I left a few comments and I like Tamal's suggestion.
Also, protoc got bumped to 3.1.0 in a8f098923c31abf1f2a075c451a4a78487a66a28a and that should be reflected here.
@@ -35,6 +36,8 @@ make | |||
make check | |||
sudo make install | |||
``` | |||
If you are using cygwin and ProtocolBuffers 3.0.0-beta-3 or later is not available for cygwin yet install the Windows version. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
would it be appropriate to place windows instructions in its own section?
@@ -128,7 +136,7 @@ Make sure that your `$GOPATH/bin` is in your `$PATH`. | |||
|
|||
It will generate a reverse proxy `path/to/your_service.pb.gw.go`. | |||
|
|||
Note: After generating the code for each of the stubs, in order to build the code, you will want to run ```go get .``` from the directory containing the stubs. | |||
Note: After generating the code for each of the stubs, in order to build the code, you will want to move the stubs into your `$GOPATH/src` working directory and run ```go get .``` from the directory containing the stubs. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
how about we recommend that folks work inside of GOPATH over moving files after gen?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
the protoc command creates the stubs in the same directory as the service.proto file. is it possible to provide an output directory for the protoc plugins?
|
||
Run this inside the directory containg your `main.go`. | ||
``` | ||
go build |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
let's recommend go install instead
@mrt181 still need a CLA sign here |
Already done? |
@mrt181 thanks! there are a few outstanding comments/suggestions. |
I would suggest to reject this PR. |
@mrt181 thanks for the great documentation contribution! |
…easier. #346