Skip to content

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

Merged
merged 3 commits into from
Aug 8, 2018

Conversation

peterkellydev
Copy link

@peterkellydev peterkellydev commented Jul 31, 2018

Prepare project for release as open-source

- Some file renaming
- Addition of open source documentation
- Improve README and Makefile

Copy link
Contributor

@pleshakov pleshakov left a 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!
Copy link
Contributor

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 !

Copy link
Author

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).
Copy link
Contributor

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)
Copy link
Contributor

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.
Copy link
Contributor

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.

Copy link
Author

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
```
Copy link
Contributor

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:
Copy link
Contributor

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

@pleshakov pleshakov left a 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.
Copy link
Contributor

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

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
```

Copy link
Contributor

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.

@peterkellydev peterkellydev merged commit ee09bf6 into master Aug 8, 2018
@peterkellydev peterkellydev deleted the release-prep branch August 8, 2018 09:52
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.

4 participants