Skip to content
This repository was archived by the owner on Jul 23, 2024. It is now read-only.

Commit e737508

Browse files
committed
Initial commit
0 parents  commit e737508

17 files changed

+617
-0
lines changed

.github/CODEOWNERS

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# Explanation of this file
2+
# https://help.github.com/articles/about-codeowners/
3+
4+
* @aessing
5+
6+
###############################################################################
7+
# This is a comment.
8+
# Each line is a file pattern followed by one or more owners.
9+
10+
# These owners will be the default owners for everything in
11+
# the repo. Unless a later match takes precedence,
12+
# @global-owner1 and @global-owner2 will be requested for
13+
# review when someone opens a pull request.
14+
#* @global-owner1 @global-owner2
15+
16+
# Order is important; the last matching pattern takes the most
17+
# precedence. When someone opens a pull request that only
18+
# modifies JS files, only @js-owner and not the global
19+
# owner(s) will be requested for a review.
20+
#*.js @js-owner
21+
22+
# You can also use email addresses if you prefer. They'll be
23+
# used to look up users just like we do for commit author
24+
# emails.
25+
#*.go docs@example.com
26+
27+
# In this example, @doctocat owns any files in the build/logs
28+
# directory at the root of the repository and any of its
29+
# subdirectories.
30+
#/build/logs/ @doctocat
31+
32+
# The `docs/*` pattern will match files like
33+
# `docs/getting-started.md` but not further nested files like
34+
# `docs/build-app/troubleshooting.md`.
35+
#docs/* docs@example.com
36+
37+
# In this example, @octocat owns any file in an apps directory
38+
# anywhere in your repository.
39+
#apps/ @octocat
40+
41+
# In this example, @doctocat owns any file in the `/docs`
42+
# directory in the root of your repository.
43+
#/docs/ @doctocat

.github/FUNDING.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
github: aessing

.github/ISSUE_TEMPLATE/bug_report.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
name: Bug report
3+
about: Create a report to help to improve the project
4+
title: ''
5+
labels: 'bug'
6+
assignees: ''
7+
---
8+
9+
<!-- Please provide a general summary of the issue in the title above -->
10+
11+
## Description
12+
<!-- Please provide a more detailed introduction to the issue itself, and why you consider it to be a bug -->
13+
14+
## Expected Behavior
15+
<!-- Please provide, what should happen -->
16+
17+
## Actual Behavior
18+
<!-- Please provide, what happens instead -->
19+
20+
## Context
21+
<!-- How has this bug affected you? What were you trying to accomplish? -->
22+
23+
## Possible Fix
24+
<!-- Not obligatory, but suggest a fix or reason for the bug -->
25+
26+
## Steps to Reproduce
27+
<!-- Please provide a link to a live example, or an unambiguous set of steps to reproduce this bug. Include code to reproduce, if relevant -->
28+
1. Go to '...'
29+
2. Click on '....'
30+
3. Scroll down to '....'
31+
4. See error
32+
33+
## Your Environment
34+
<!-- Please include as many relevant details about the environment you experienced the bug in -->
35+
- Version used:
36+
- Environment name and version (e.g. Chrome 39, node.js 5.4):
37+
- Operating System and version
38+
- Desktop or mobile:
39+
- Hardware used:
40+
- etc.
41+
42+
## Screenshots
43+
<!-- If applicable, please add screenshots to help explain your problem. -->
44+
45+
## Additional context
46+
<!-- Please add any other context about the problem here. -->

.github/ISSUE_TEMPLATE/config.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
blank_issues_enabled: false
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
name: Critical bug report
3+
about: Create a report for a critical issue
4+
title: ''
5+
labels: 'bug, critical'
6+
assignees: ''
7+
---
8+
9+
<!-- Please provide a general summary of the issue in the title above -->
10+
11+
## Description
12+
<!-- Please provide a more detailed introduction to the issue itself, and why you consider it to be a bug -->
13+
14+
## Expected Behavior
15+
<!-- Please provide, what should happen -->
16+
17+
## Actual Behavior
18+
<!-- Please provide, what happens instead -->
19+
20+
## Context
21+
<!-- How has this bug affected you? What were you trying to accomplish? -->
22+
23+
## Possible Fix
24+
<!-- Not obligatory, but suggest a fix or reason for the bug -->
25+
26+
## Steps to Reproduce
27+
<!-- Please provide a link to a live example, or an unambiguous set of steps to reproduce this bug. Include code to reproduce, if relevant -->
28+
1. Go to '...'
29+
2. Click on '....'
30+
3. Scroll down to '....'
31+
4. See error
32+
33+
## Your Environment
34+
<!-- Please include as many relevant details about the environment you experienced the bug in -->
35+
- Version used:
36+
- Environment name and version (e.g. Chrome 39, node.js 5.4):
37+
- Operating System and version
38+
- Desktop or mobile:
39+
- Hardware used:
40+
- etc.
41+
42+
## Screenshots
43+
<!-- If applicable, please add screenshots to help explain your problem. -->
44+
45+
## Additional context
46+
<!-- Please add any other context about the problem here. -->
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
name: Documentation issue
3+
about: Report issues in the documentation
4+
title: ''
5+
labels: 'documentation'
6+
assignees: ''
7+
---
8+
9+
<!-- Please provide a general summary of the issue in the title above -->
10+
11+
## URL to the Article
12+
<!-- Please provide to the document that you report the issue for -->
13+
14+
## Description
15+
<!-- Please provide a more detailed introduction to the issue itself, and why you consider it to be a documentation issue -->
16+
17+
## Expected Documentation
18+
<!-- Please tell what you expected to find in the documentation -->
19+
20+
## Actual Documentation
21+
<!-- Please tell what you found in the documentation -->
22+
23+
## Context
24+
<!-- How has this issue affected you? What were you trying to accomplish? -->
25+
26+
## Possible Fix
27+
<!-- Not obligatory, but suggest a fix or reason for the issue -->
28+
29+
## Screenshots
30+
<!-- If applicable, please add screenshots to help explain your problem. -->
31+
32+
## Additional context
33+
<!-- Please add any other context about the problem here. -->
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
name: Feature request
3+
about: Suggest an idea for this project
4+
title: ''
5+
labels: 'feature'
6+
assignees: ''
7+
---
8+
9+
<!-- Please provide a general summary of the feature request in the title above -->
10+
11+
## Detailed Description
12+
<!-- Please provide a detailed description of the change or addition you are proposing -->
13+
14+
## Context
15+
<!-- Why is this change important to you? How would you use it? How can it benefit other users? -->
16+
17+
## Possible Implementation
18+
<!-- Not obligatory, but please suggest an idea for implementing addition or change -->
19+
20+
## Describe Alternatives
21+
<!-- Please provide a clear and concise description of any alternative solutions or features you've considered. -->
22+
23+
## Additional context
24+
<!-- Please add any other context or screenshots about the feature request here. -->

.github/ISSUE_TEMPLATE/question.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
name: Question
3+
about: You have a question about the project?
4+
title: ''
5+
labels: 'question'
6+
assignees: ''
7+
---
8+
9+
<!-- Please ask your question and provide as much detail as you can. So you help us to provide the best possible answer -->

.github/pull_request_template.md

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
<!-- Please provide a general summary of your changes in the title above -->
2+
3+
# Pull Request
4+
Thank you for your contribution.
5+
6+
Before submitting this Pull Request, please make sure: _Put an `x` in the boxes that apply_
7+
- [ ] You reviewed our [guidelines for contributing](../CONTRIBUTING.md) to this repository
8+
- [ ] Does an issue exists which is related to this Pull Request <!--- This project only accepts Pull Requests related to open issues -->
9+
- [ ] Your code builds clean without any errors or warnings
10+
- [ ] You are using approved terminology
11+
- [ ] You have added necessary documentation (if appropriate)
12+
- [ ] You have added unit tests
13+
14+
## Proposed changes
15+
<!-- Please describe the big picture of your changes here to communicate to the maintainers why we should accept this Pull Request. Why is this change required? What problem does it solve? -->
16+
17+
## Types of changes
18+
What types of changes does your change introduce? _Put an `x` in the boxes that apply_
19+
- [ ] New feature (adds functionality) <!-- If suggesting a new feature or change, please discuss it in an issue first -->
20+
- [ ] Bugfix (fixes an issue) <!-- If fixing a bug, there should be an issue describing it with steps to reproduce -->
21+
- [ ] Security (fixes an security issue) | Please have a look at our [Security Policy](../SECURITY.md) first.
22+
- [ ] Code style cleaning or Refactoring (formatting, renaming, restructuring, etc.)
23+
- [ ] Documentation Update
24+
- [ ] Other (please describe):
25+
26+
## Breaking change
27+
Does this Pull Request cause existing functionality to not work as expected or even break. _Put an `x` in the boxes that apply_
28+
- [ ] Yes
29+
- [ ] No
30+
31+
## Solution Description
32+
<!-- Describe your code changes in detail. Explain the technical solution you have provided and how it supports the project. Also explain why you chose the solution you did and what alternatives you considered, etc...-->
33+
34+
## How has this been tested?
35+
<!--- Please describe in detail how you tested your changes. Include details of your testing environment, and the tests you ran to see how your change affects other areas of the code, etc. -->
36+
37+
## Deploy Notes
38+
<!-- Notes regarding deployment of your work. These should note any step, like db migrations, manual work, organizational stuff, etc.-->
39+
40+
## Impacted Areas
41+
<!-- Please list parts of the project that this Pull Request will affect -->
42+
- Area 1
43+
- Area 2
44+
- ...
45+
46+
## Related Issues
47+
<!-- Please list and link to related issues -->
48+
Issue Name | Issue Number
49+
------------------| ----------------------------
50+
FIRST ISSUE NAME | [#1](/user/project/issues/1)
51+
SECOND ISSUE NAME | [#2](/user/project/issues/2)
52+
... | ...
53+
54+
## Related Pull Requests
55+
<!-- Please list and link related Pull Requests against other branches -->
56+
Branch | Pull Request
57+
----------------------| --------------------------
58+
ft-NNN-NAME-TRACKERID | [#1](/user/project/pull/1)
59+
bg-NNN-NAME-TRACKERID | [#2](/user/project/pull/2)
60+
... | ...

.media/UCK-G2-PLUS.png

176 KB
Loading

CODE_OF_CONDUCT.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# :cop: Code of Conduct
2+
3+
This Code of Conduct outlines expectations for participation in the community, as well as steps for reporting unacceptable behavior. We are committed to providing a welcoming and inspiring community for all. People violating this code of conduct may be banned from the community.
4+
5+
This community strive to:
6+
7+
- __Be friendly and patient__: Remember you might not be communicating in someone else's primary spoken or programming language, and others may not have your level of understanding.
8+
- __Be welcoming__: This community welcomes and support people of all backgrounds and identities. This includes, but is not limited to members of any race, ethnicity, culture, national origin, color, immigration status, social and economic class, educational level, level of experience, sex, sexual identity and orientation, gender identity and expression, personal appearance, age, size, family status, political belief, religion, and mental and physical ability.
9+
- __Be respectful__: This is a world-wide community of professionals, and we conduct ourselves professionally. Disagreement is no excuse for poor behavior and poor manners. Disrespectful and unacceptable behavior includes, but is not limited to:
10+
- Violent threats or language.
11+
- Discriminatory or derogatory jokes and language.
12+
- Posting sexually explicit or violent material.
13+
- Posting, or threatening to post, peoples personally identifying information ("doxing").
14+
- Insults, especially those using discriminatory terms or slurs.
15+
- Behavior that could be perceived as sexual attention.
16+
- Trolling.
17+
- Other conduct which could reasonably be considered inappropriate in a professional setting.
18+
- Advocating for or encouraging any of the above behaviors.
19+
- __Understand disagreements__: Disagreements, both social and technical, are useful learning opportunities. Seek to understand the other viewpoints and resolve differences constructively.
20+
- This code is not exhaustive or complete. It serves to capture the common understanding of a productive, collaborative environment. We expect the code to be followed in spirit as much as in the letter.
21+
22+
## :telescope: Scope
23+
24+
This code of conduct applies to all repos and communities for our projects regardless of whether or not the repo explicitly calls out its use of this code. The code also applies in public spaces when an individual is representing a project or its community. Examples 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.
25+
26+
## :man_in_tuxedo: Responsibilities
27+
28+
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.
29+
30+
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.
31+
32+
## :mega: Reporting Code of Conduct Issues
33+
34+
Whenever possible, the community should try to resolve issues on their own. This builds a broader and deeper understanding and ultimately a healthier interaction. In the event that an issue cannot be resolved locally, please feel free to report your concerns by contacting [codeofconduct@essing.org](mailto:codeofconduct@essing.org).
35+
36+
In your report please include:
37+
- Your contact information.
38+
- Names (real, usernames or pseudonyms) of any individuals involved. If there are additional witnesses, please include them as well.
39+
- Your account of what occurred, and if you believe the incident is ongoing. If there is a publicly available record (e.g. a mailing list archive or a public chat log), please include a link or attachment.
40+
- Any additional information that may be helpful.
41+
42+
All reports will be reviewed and will result in a response that is deemed necessary and appropriate to the circumstances. Where additional perspectives are needed, we may seek insights from others with relevant expertise or experience. The confidentiality of the person reporting the incident will always be kept.
43+
44+
Anyone asked to stop unacceptable behavior is expected to comply immediately. If an individual engages in unacceptable behavior, we may take any action we deem appropriate, including a permanent ban from the community.
45+
46+
## :receipt: Attribution
47+
48+
This code of conduct is based on the template established by the [TODO Group](http://todogroup.org/) and used by numerous other large communities (e.g., [Microsoft](https://opensource.microsoft.com/codeofconduct/), [Facebook](https://code.facebook.com/pages/876921332402685/open-source-code-of-conduct), Twitter, GitHub and the Scope section from the [Contributor Covenant version 1.4](http://contributor-covenant.org/version/1/4/).

CONTRIBUTING.md

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# :construction_worker: Contributor's Guide
2+
3+
Below is the guidance for how to report issues, propose new features, and submit contributions via Pull Requests.
4+
5+
## :beetle: Before you start, file an issue
6+
7+
Please follow this simple rule to help us stop any unnecessary effort and frustration, so we all can ensure an efficient and effective use of everyone's time - yours, ours, and the time of other community members.
8+
9+
> If you have a question, or do you think you have discovered an issue, or would you like to propose a new feature, etc., then find/file an issue before starting work to fix or implement it.
10+
>
11+
>:exclamation: **For security issues please have a look at the [Security Policy](SECURITY.md)** :exclamation:
12+
13+
### :mag_right: Search existing issues first
14+
15+
Before filing a new issue, search existing open and closed issues first. Perhaps someone else has found the problem you are seeing, and someone may be working on or have already contributed a fix.
16+
17+
If no existing item describes your issue/feature, great - please file a new issue.
18+
19+
### :keyboard: File a new Issue
20+
21+
- You found a security issue and you want to report it? Please have a look at the [Security Policy](SECURITY.md).
22+
- You have found a bug and you want to report it? Please file an issue with the tag "bug".
23+
- You have found something critical, perhaps a bug where data can be lost, etc.? Please file an issue with the tag "critical".
24+
- You got a great idea for a new feature? Please file an issue with the tag "feature".
25+
- You have a question that you do not see answered in docs, videos, etc.? Please file an issue with the tag "documentation".
26+
- You found an existing issue that describes yours? Great - please upvote and add additional commentary / info / repro-steps / etc.
27+
28+
### :pencil: Complete the template
29+
30+
Please include as much information as possible in your issue. The more information you provide, the more likely your issue/ask will be understood, accepted, and implemented.
31+
32+
- Do not assume somebody other than you is an expert in setting up your environment and do not assume somebody else is an expert in your workflow. Please tell us as much details you can, so we can help you as good as possible!
33+
- What steps are needed to reproduce the issue? Assume we love to read repro steps. As much detail as you can stand is probably barely enough detail for us.
34+
- We prefer error message text where possible, or screenshots of errors if the error text cannot be captured.
35+
- If you intend to implement the fix/feature yourself, please say so! If you do not indicate you want to contribute, we assume that the issue is our to solve.
36+
37+
### :+1: Do not post "+1" comments
38+
39+
> Please do not post "+1", "me too", or similar comments - these comments just add noise to an issue.
40+
41+
If you do not have any additional information to add but would like to indicate that you are affected by the issue, upvote the original issue by clicking its :smiley:-button and hitting :+1: (+1) icon. This way it is much easier to measure how impactful an issue is.
42+
43+
---
44+
45+
## :man_technologist: Development
46+
47+
### :toolbox: Fork, Clone, Branch and Create your PR
48+
49+
Once you have filed an issue and discussed your proposed feature/fix, it is time to start development:
50+
51+
1. Fork the repo if you have not already
52+
2. Clone your fork locally
53+
3. Create & push a feature branch
54+
4. Create a [Draft Pull Request](https://github.blog/2019-02-14-introducing-draft-pull-requests/)
55+
5. Work on your changes
56+
57+
### :eyeglasses: Code Review
58+
59+
When you would like the project team to take a look, (even if the work is not yet fully-complete), mark the Pull Request as 'Ready For Review' so that the team can review your work and provide comments, suggestions, and request changes. We would like to encourage you to use the Pull Request as tool to start a conversation around your ideas and recruit people to help if necessary. It may take several cycles, but the result will be solid, testable, conformant code that is safe to merge.
60+
61+
### :jigsaw: Merge
62+
63+
Once your code has been reviewed and approved, it will be merged. Once merged, your Pull Request will be automatically closed.
64+
65+
---
66+
67+
## :balloon: Thank you
68+
69+
Thank you in advance for your contribution!

0 commit comments

Comments
 (0)