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

Added additonal information for installation and usage to make setup … #347

Closed
wants to merge 1 commit into from

Conversation

mrt181
Copy link

@mrt181 mrt181 commented Apr 4, 2017

…easier. #346

@tamalsaha
Copy link
Collaborator

Since 1.8, GOPATH env var is not required. golang/go#17262 . A backward compatible alternative is $(go env GOPATH)

Copy link
Collaborator

@tmc tmc left a 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.
Copy link
Collaborator

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.
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 we recommend that folks work inside of GOPATH over moving files after gen?

Copy link
Author

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
Copy link
Collaborator

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

@tmc
Copy link
Collaborator

tmc commented Apr 15, 2017

@mrt181 still need a CLA sign here

@mrt181
Copy link
Author

mrt181 commented Apr 15, 2017

Already done?
Agreement Name Date Signed
Google Individual CLA Martin Thomalla Apr 04, 2017 14:28 PDT

@tmc
Copy link
Collaborator

tmc commented Apr 17, 2017

@mrt181 thanks! there are a few outstanding comments/suggestions.

@mrt181
Copy link
Author

mrt181 commented Apr 25, 2017

I would suggest to reject this PR.
While redoing the installation on another machine I experienced a more involved installation process for cygwin. I have created a wiki page for cygwin installation documenting the different steps that were required to go install an grpc-gateway service.

@tmc
Copy link
Collaborator

tmc commented Apr 25, 2017

@mrt181 thanks for the great documentation contribution!

@tmc tmc closed this Apr 25, 2017
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.

3 participants