Skip to content

Commit 3dd46cd

Browse files
docktermjdocktermj
committed
issue-1 Initial content
1 parent bb0757d commit 3dd46cd

13 files changed

+421
-1
lines changed

‎.github/ISSUE_TEMPLATE/bug_report.md

+38
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
name: Bug report
3+
about: Create a report to help us improve
4+
5+
---
6+
7+
**Describe the bug**
8+
A clear and concise description of what the bug is.
9+
10+
**To Reproduce**
11+
Steps to reproduce the behavior:
12+
13+
1. Go to '...'
14+
2. Click on '....'
15+
3. Scroll down to '....'
16+
4. See error
17+
18+
**Expected behavior**
19+
A clear and concise description of what you expected to happen.
20+
21+
**Screenshots**
22+
If applicable, add screenshots to help explain your problem.
23+
24+
**Desktop (please complete the following information):**
25+
26+
- OS: [e.g. iOS]
27+
- Browser [e.g. chrome, safari]
28+
- Version [e.g. 22]
29+
30+
**Smartphone (please complete the following information):**
31+
32+
- Device: [e.g. iPhone6]
33+
- OS: [e.g. iOS8.1]
34+
- Browser [e.g. stock browser, safari]
35+
- Version [e.g. 22]
36+
37+
**Additional context**
38+
Add any other context about the problem here.

‎.github/ISSUE_TEMPLATE/feature_request.md

+17
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
name: Feature request
3+
about: Suggest an idea for this project
4+
5+
---
6+
7+
**Is your feature request related to a problem? Please describe.**
8+
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
9+
10+
**Describe the solution you'd like**
11+
A clear and concise description of what you want to happen.
12+
13+
**Describe alternatives you've considered**
14+
A clear and concise description of any alternative solutions or features you've considered.
15+
16+
**Additional context**
17+
Add any other context or screenshots about the feature request here.

‎.github/README_TEMPLATE/demonstration/README.md

+15
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# name-of-repository
2+
3+
## Overview
4+
5+
This demonstration shows...
6+
7+
## Install
8+
9+
These instructions will install and run...
10+
11+
## Test
12+
13+
## References
14+
15+
1. [Senzing](http://senzing.com)

‎.github/senzing-corporate-contributor-license-agreement.pdf

58.4 KB
Binary file not shown.

‎.github/senzing-individual-contributor-license-agreement.pdf

68.4 KB
Binary file not shown.

‎.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
target/

‎.project

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<projectDescription>
3+
<name>docker-db2</name>
4+
</projectDescription>

‎CODE_OF_CONDUCT.md

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

‎CONTRIBUTING.md

+124
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
# Contributing
2+
3+
Welcome to the project!
4+
5+
We encourage contribution in a manner consistent with the [Code of Conduct](CODE_OF_CONDUCT.md).
6+
The following will guide you through the process.
7+
8+
There are a number of ways you can contribute:
9+
10+
1. [Asking questions](#questions)
11+
1. [Requesting features](#feature-requests)
12+
1. [Reporting bugs](#bug-reporting)
13+
1. [Contributing code or documentation](#contributing-code-or-documentation)
14+
15+
## License Agreements
16+
17+
If your contribution modifies the git repository, the following agreements must be established.
18+
19+
*Note:* License agreements are only needed for adding, modifying, and deleting artifacts kept within the repository.
20+
In simple terms, license agreements are needed before pull requests can be accepted.
21+
A license agreement is not needed for submitting feature request, bug reporting, or other project management.
22+
23+
### Individual Contributor License Agreement
24+
25+
In order to contribute to this repository, an
26+
[Individual Contributor License Agreement (ICLA)](.github/senzing-individual-contributor-license-agreement.pdf)
27+
must be completed, submitted and accepted.
28+
29+
### Corporate Contributor License Agreement
30+
31+
If the contribution to this repository is on behalf of a company, a
32+
[Corporate Contributor License Agreement (CCLA)](.github/senzing-corporate-contributor-license-agreement.pdf)
33+
must also be completed, submitted and accepted.
34+
35+
### Project License Agreement
36+
37+
The license agreement for this repository is stated in the
38+
[LICENSE](LICENSE) file.
39+
40+
## Questions
41+
42+
Please do not use the GitHub issue tracker to submit questions.
43+
44+
TODO: Instead, use ???
45+
46+
1. ??? Slack ???
47+
1. ??? stackoverflow.com ???
48+
49+
## Feature Requests
50+
51+
All feature requests are "GitHub issues".
52+
To request a feature, create a
53+
[GitHub issue](https://help.github.com/articles/creating-an-issue/)
54+
in this repository.
55+
56+
When creating an issue, there will be a choice to create a "Bug report" or a "Feature request".
57+
Choose "Feature request".
58+
59+
## Bug Reporting
60+
61+
All bug reports are "GitHub issues".
62+
Before reporting on a bug, check to see if it has
63+
[already been reported](https://github.com/search?q=+is%3Aissue+user%3Asenzing).
64+
To report a bug, create a
65+
[GitHub issue](https://help.github.com/articles/creating-an-issue/)
66+
in this repository.
67+
68+
When creating an issue, there will be a choice to create a "Bug report" or a "Feature request".
69+
Choose "Bug report".
70+
71+
## Contributing code or documentation
72+
73+
To contribute code or documentation to the repository, you must have
74+
[License Agreements](#license-agreements) in place.
75+
This needs to be complete before a [Pull Request](#pull-requests) can be accepted.
76+
77+
### Setting up a development environment
78+
79+
#### Set Environment variables
80+
81+
These variables may be modified, but do not need to be modified.
82+
The variables are used throughout the installation procedure.
83+
84+
```console
85+
export GIT_ACCOUNT=senzing
86+
export GIT_REPOSITORY=docker-db2
87+
```
88+
89+
Synthesize environment variables.
90+
91+
```console
92+
export GIT_ACCOUNT_DIR=~/${GIT_ACCOUNT}.git
93+
export GIT_REPOSITORY_DIR="${GIT_ACCOUNT_DIR}/${GIT_REPOSITORY}"
94+
export GIT_REPOSITORY_URL="[email protected]:${GIT_ACCOUNT}/${GIT_REPOSITORY}.git"
95+
```
96+
97+
#### Clone repository
98+
99+
Get repository.
100+
101+
```console
102+
mkdir --parents ${GIT_ACCOUNT_DIR}
103+
cd ${GIT_ACCOUNT_DIR}
104+
git clone ${GIT_REPOSITORY_URL}
105+
cd ${GIT_REPOSITORY_DIR}
106+
```
107+
108+
### Coding conventions
109+
110+
TODO:
111+
112+
### Testing
113+
114+
TODO:
115+
116+
### Pull Requests
117+
118+
Code in the master branch is modified via GitHub pull request.
119+
Follow GitHub's
120+
[Creating a pull request from a branch](https://help.github.com/articles/creating-a-pull-request/)
121+
or
122+
[Creating a pull request from a fork](https://help.github.com/articles/creating-a-pull-request-from-a-fork/) instructions.
123+
124+
Accepting pull requests will be at the discretion of Senzing, Inc. and the repository owner(s).

‎Dockerfile

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
FROM ibmcom/db2express-c:latest
2+
3+
ENV REFRESHED_AT=2018-11-01
4+
5+
CMD ["/bin/bash"]

‎Makefile

+38
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Git variables
2+
3+
GIT_REPOSITORY_NAME := $(shell basename `git rev-parse --show-toplevel`)
4+
GIT_VERSION := $(shell git describe --always --tags --long --dirty | sed -e 's/\-0//' -e 's/\-g.......//')
5+
6+
# -----------------------------------------------------------------------------
7+
# The first "make" target runs as default.
8+
# -----------------------------------------------------------------------------
9+
10+
.PHONY: default
11+
default: help
12+
13+
# -----------------------------------------------------------------------------
14+
# Docker-based builds
15+
# -----------------------------------------------------------------------------
16+
17+
.PHONY: docker-build
18+
docker-build: docker-rmi
19+
docker build \
20+
--tag senzing/db2 \
21+
--tag senzing/db2:$(GIT_VERSION) \
22+
.
23+
24+
# -----------------------------------------------------------------------------
25+
# Utility targets
26+
# -----------------------------------------------------------------------------
27+
28+
.PHONY: docker-rmi
29+
docker-rmi:
30+
-docker rmi --force senzing/db2:$(GIT_VERSION) senzing/db2
31+
32+
.PHONY: clean
33+
clean: docker-rmi
34+
35+
.PHONY: help
36+
help:
37+
@echo "List of make targets:"
38+
@$(MAKE) -pRrq -f $(lastword $(MAKEFILE_LIST)) : 2>/dev/null | awk -v RS= -F: '/^# File/,/^# Finished Make data base/ {if ($$1 !~ "^[#.]") {print $$1}}' | sort | egrep -v -e '^[^[:alnum:]]' -e '^$@$$' | xargs

‎PULL_REQUEST_TEMPLATE.md

+13
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Pull request questions
2+
3+
## Which issue does this address
4+
5+
ISSUE-???
6+
7+
## Why was change needed
8+
9+
???
10+
11+
## What does change improve
12+
13+
???

0 commit comments

Comments
 (0)