-
Notifications
You must be signed in to change notification settings - Fork 25
Release preparation including some renaming and some additional files #6
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
Conversation
33636c6
to
f993602
Compare
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.
Additional notes:
- please mention a license in the readme
- please mention that this project is not covered by NGINX Plus support contract.
CONTRIBUTING.md
Outdated
@@ -0,0 +1,138 @@ | |||
# Contributing Guidelines | |||
|
|||
The following is a set of guidelines for contributing to the NGINX AWS Auto-Scale Group Sync tool. We really appreciate that you are considering contributing! |
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.
NGINX AWS Auto-Scale Group Sync tool -> NGINX Plus Golang SDK
!
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.
Good catch, btw @pleshakov you need to stop referring to Go as Golang everywhere. That is against the naming guidelines of the Go project, it is just "Go"
CONTRIBUTING.md
Outdated
|
||
## Getting Started | ||
|
||
Read the usage and testing steps in the [README](https://github.com/nginxinc/nginx-plus-go-sdk/blob/master/README.md). |
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.
use a relative link
CONTRIBUTING.md
Outdated
### Open a Pull Request | ||
|
||
* Fork the repo, create a branch, submit a PR when your changes are tested and ready for review | ||
* You will be asked to fill in [our pull request template](https://github.com/nginxinc/nginx-plus-go-sdk/blob/master/.github/PULL_REQUEST_TEMPLATE.md) |
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.
why not a relative link?
|
||
## Using the SDK | ||
|
||
For now, copy `client/nginx_client.go` into your go project. | ||
1. Import `github.com/nginxinc/nginx-plus-go-sdk/client` into your go project. | ||
2. Use your favourite vendor tool to add this to your `/vendor` directory in your project. |
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.
Perhaps it is worth including a simple example? We can use the demo.nginx.com instance in that example.
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.
no need
|
||
## Testing | ||
|
||
### Unit tests | ||
``` |
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.
please use $
in shell commands, such as $ make clean
README.md
Outdated
|
||
This will build and run an NGINX Plus container, execute the SDK tests against NGINX Plus API, and then clean up: |
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.
make a note that if the test fail, to remove the container, you need to run $ make clean
- Some file renaming - Addition of open source documentation - Improve README and Makefile
f993602
to
a622b0c
Compare
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.
additionally, could you change the title of readme to "NGINX Plus API Go SDK"?
LICENSE
Outdated
same "printed page" as the copyright notice for easier | ||
identification within third-party archives. | ||
|
||
Copyright 2016 Nginx, Inc. |
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.
2016 was a good year
README.md
Outdated
|
||
## Support | ||
This project is not covered by the NGINX Plus support contract |
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.
.
at the end
|
||
``` | ||
$ make test | ||
``` | ||
|
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.
.
at the end
@@ -4,34 +4,36 @@ This SDK includes a client library for working with NGINX Plus API. | |||
|
|||
## About the SDK | |||
|
|||
`client/nginx_client.go` includes functions and data structures for working with NGINX Plus API as well as some helper functions. | |||
`client/nginx.go` includes functions and data structures for working with NGINX Plus API as well as some helper functions. |
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
1e13d50
to
0eb5ebf
Compare
0eb5ebf
to
3bba948
Compare
Prepare project for release as open-source