Skip to content

Commit a5c9a86

Browse files
authored
Issue 1 (#16)
* added CONTRIBUTING.md and other boilerplate * remove tegola-specific stuff
1 parent f13e7f0 commit a5c9a86

File tree

5 files changed

+182
-0
lines changed

5 files changed

+182
-0
lines changed

.github/ISSUE_TEMPLATE/bug.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
## Actual Behavior
2+
3+
4+
## Expected Behavior
5+
6+
7+
## Steps to reproduce the issue.
8+
9+
10+
## Data used
11+

.github/ISSUE_TEMPLATE/feature.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
## Requested Behavior
2+
3+
4+
## Use Cases
5+
6+
7+
## Current work arounds to accomplish current behavior.
8+

CODE_OF_CONDUCT.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
# go-spatial/proj Code of Conduct
2+
3+
## Our Pledge
4+
5+
In the interest of fostering an open and welcoming environment, we as
6+
contributors and maintainers pledge to making participation in our project and
7+
our community a harassment-free experience for everyone, regardless of age, body
8+
size, disability, ethnicity, gender identity and expression, level of experience,
9+
education, socio-economic status, nationality, personal appearance, race,
10+
religion, or sexual identity and orientation.
11+
12+
## Our Standards
13+
14+
Examples of behavior that contributes to creating a positive environment
15+
include:
16+
17+
* Using welcoming and inclusive language
18+
* Being respectful of differing viewpoints and experiences
19+
* Gracefully accepting constructive criticism
20+
* Focusing on what is best for the community
21+
* Showing empathy towards other community members
22+
23+
Examples of unacceptable behavior by participants include:
24+
25+
* The use of sexualized language or imagery and unwelcome sexual attention or
26+
advances
27+
* Trolling, insulting/derogatory comments, and personal or political attacks
28+
* Public or private harassment
29+
* Publishing others' private information, such as a physical or electronic
30+
address, without explicit permission
31+
* Other conduct which could reasonably be considered inappropriate in a
32+
professional setting
33+
34+
## Our Responsibilities
35+
36+
Project maintainers are responsible for clarifying the standards of acceptable
37+
behavior and are expected to take appropriate and fair corrective action in
38+
response to any instances of unacceptable behavior.
39+
40+
Project maintainers have the right and responsibility to remove, edit, or
41+
reject comments, commits, code, wiki edits, issues, and other contributions
42+
that are not aligned to this Code of Conduct, or to ban temporarily or
43+
permanently any contributor for other behaviors that they deem inappropriate,
44+
threatening, offensive, or harmful.
45+
46+
## Scope
47+
48+
This Code of Conduct applies both within project spaces and in public spaces
49+
when an individual is representing the project or its community. Examples of
50+
representing a project or community include using an official project e-mail
51+
address, posting via an official social media account, or acting as an appointed
52+
representative at an online or offline event. Representation of a project may be
53+
further defined and clarified by project maintainers.
54+
55+
## Enforcement
56+
57+
Instances of abusive, harassing or otherwise unacceptable behavior may be
58+
reported by contacting the project team in the [#go-spatial](https://invite.slack.golangbridge.org/) channel. All
59+
complaints will be reviewed and investigated and will result in a response that
60+
is deemed necessary and appropriate to the circumstances. The project team is
61+
obligated to maintain confidentiality with regard to the reporter of an incident.
62+
Further details of specific enforcement policies may be posted separately.
63+
64+
Project maintainers who do not follow or enforce the Code of Conduct in good
65+
faith may face temporary or permanent repercussions as determined by other
66+
members of the project's leadership.
67+
68+
## Attribution
69+
70+
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
71+
available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
72+

CONTRIBUTING.md

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
# Welcome
2+
3+
Thank you for even thinking about contributing! We are excited to have you. This document is intended as a guide to help your through the contribution process. This guide assumes a you have a basic understanding of Git and Go.
4+
5+
For sensitive security-related issue please start a conversation with a core contributor on the [#go-spatial](https://invite.slack.golangbridge.org/) channel in the [gophers slack](https://invite.slack.golangbridge.org/) organization.
6+
7+
This project and everyone participating in it is governed by the [Code of Conduct](CODE_OF_CONDUCT.md).
8+
By participating, you are expected to uphold this code. Please report unacceptable behavior to the [#go-spatial](https://invite.slack.golangbridge.org/) channel in the [gophers slack](https://invite.slack.golangbridge.org/) organization or to one of the Core Contributors.
9+
10+
## There are several places where you can contribute.
11+
12+
### Found a bug or something doesn’t feel right?
13+
14+
Everything we do is done through [issues](https://github.com/go-spatial/proj/issues)(https://github.com/go-spatial/proj/issues). The first thing to do is to search the current issues to see if it is something that has been reported or requested already. If you are unable to find an issue that is similar or are unsure just file a new issue. If you find one that is similar, you can add a comment to add additional details, or if you have nothing new to add you can “+1” the issue.
15+
16+
* If you are unable to find an issue that is similar or are unsure go ahead and file a new one.
17+
* If it is a bug, your can use the following [template](https://github.com/go-spatial/proj/issues/new?template=bug.md).
18+
* If this is a rendering bug, please include the relevant data set and configuration file.
19+
* If it is a feature request use the following [template](https://github.com/go-spatial/proj/issues/new?template=feature.md).
20+
* If this is a feature request, please include a description of what the feature is, and the use case for the feature.
21+
22+
Once you have filed an issue, we will discuss it in the issue. If we need more information or you have further questions about that issue, this is the place to ask. This is the place where we will discuss the design of the fix or feature. Any pull request that adds a feature or fixes an issue should reference the issue number.
23+
24+
Don’t be afraid to reach out if you have any questions. You can reach us on the gophers Slack on the channel #proj or #go-spatial. You can get an invite into the gophers Slack via (https://invite.slack.golangbridge.org/)
25+
26+
## Making a Contribution to the code base.
27+
28+
For the Proj project our master branch is always the most recent stable version of the code base. The current release candidate will be in a branch name for the next version of the software. For example if the current release is v0.6.1 the next release will be v0.7.0, the release candidate branch will be called “v0.7.0”. Please, base all of your pull requests on the release candidate branch.
29+
30+
### Discuss your design
31+
32+
All contributions are welcome, but please let everyone know what you are working on. The way to do this is to first file an issue (or claim an existing issue). In this issue, please, discuss what your plan is to fix or add the feature. Also, all design discussions should happen on the issue. If design discussions happen in a channel, reconcile the decisions to the relevant issue(s). Once, your contribution is ready, create a pull request referencing the issue. Once, a pull request is created one or more of the Core Contributors will review the pull request and may request changes. Once the changes are approved, it will be merged into the current release candidate branch.
33+
34+
Be sure to keep the pull request updated as merge conflicts may occur as other things get merged into the release branch before yours.
35+
36+
Please, note that we may push your pull request to the next release candidate at which point you will have to resolve any conflicts that occur.
37+
38+
### Not sure where to contribute?
39+
40+
Want to contribute but not sure where? Not a problem, the best thing to do is look through the issues and find one that interests you. If the issue has the label `good first issue`, it means that one of the core contributors thinks this is a good issue to start with. But, this doesn’t mean that you have to start with these issues. Go through the issues and see if someone is already working on it. If no one is, state that you will be working on the issue to claim it. If you are unsure where to start on the issue, ask in the issue and one of the Core Contributors will help you out.
41+
42+
## How to build from source
43+
44+
Clone the `go-spatial/proj` repo to your `GOPATH`. The simplest way to do this is to use `go get -u github.com/go-spatial/proj`, navigate to the repository root then:
45+
46+
* Checkout the current release candidate branch, (i.e. v0.7.0)
47+
48+
(`git checkout v0.7.0`)
49+
50+
* Create a new feature branch.
51+
52+
(`git checkout -b issue-XXX-new_feature`)
53+
54+
* Work on the fix, and run all the tests. We need to run tests with CGO enabled and disabled.
55+
56+
(`go test ./…`)
57+
58+
* Commit your changes (`git commit -am ‘Add some feature #XXX\n\nExtened description.'`)
59+
60+
### Contribute upstream:
61+
62+
* On github, fork the repo to into your account.
63+
* Add a new remote pointing to your fork.
64+
65+
(`git remote add fork git@github.com:yourname/rep.git`)
66+
67+
* Push to the branch
68+
69+
(`git push fork issue-XXX-new_feature`)
70+
71+
* Create a new Pull Request on GitHub against the Release Candidate branch.
72+
73+
For more information about this work flow, please refer to this [great explanation by Katrina Owen](https://splice.com/blog/contributing-open-source-git-repositories-go/).
74+
75+
## Conventions
76+
77+
* All code should be formatted using:
78+
79+
(`gofmt -s ./…`).
80+
81+
- if you find that running `gofmt` produces changes across parts of the code base you're not working on, submit the formatting change in a separate Pull Request. This helps decouple engineering changes from formatting changes and focused the code review efforts.
82+
83+
* When declaring errors variables, follow the style in the `error_strings.go` file in the `merror` package.
84+
85+
86+
## Testing
87+
88+
We try to provide both unit and system tests, and we try to provide a high code coverage percentage.

CONTRIBUTORS.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
Thank you to all the people who have [contributed](https://github.com/go-spatial/proj/graphs/contributors) to this project.
2+
3+
Thank you also to everyone who has submitted an [issue or feature](https://github.com/go-spatial/proj/issues?utf8=%E2%9C%93&q=is%3Aissue) request.

0 commit comments

Comments
 (0)