Skip to content

Commit 0649858

Browse files
committed
format markdown
1 parent 6b5ec8b commit 0649858

6 files changed

+203
-81
lines changed

Diff for: .github/ISSUE_TEMPLATE/BUG_REPORT.md

+8-4
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,12 @@ assignees: ""
88

99
## Bug Report
1010

11-
Thanks for reporting an issue, please review the task list below before submitting the
12-
issue. Your issue report will be closed if the issue is incomplete and the below tasks not completed.
11+
Thanks for reporting an issue, please review the task list below before
12+
submitting the issue. Your issue report will be closed if the issue is
13+
incomplete and the below tasks not completed.
1314

1415
## Task List
16+
1517
_Put an `x` in the boxes that apply_
1618

1719
- [ ] Steps to reproduce provided
@@ -33,7 +35,8 @@ Tell us what happens instead
3335

3436
## Steps to Reproduce
3537

36-
Please explain the steps required to duplicate the issue, especially if you are able to provide a sample application.
38+
Please explain the steps required to duplicate the issue, especially if you are
39+
able to provide a sample application.
3740

3841
1. TODO
3942
2. TODO
@@ -49,4 +52,5 @@ insert short code snippets here
4952

5053
## Further comments
5154

52-
List any other information that is relevant to your issue. Related issues, suggestions on how to fix, Stack Overflow links, forum links, etc.
55+
List any other information that is relevant to your issue. Related issues,
56+
suggestions on how to fix, Stack Overflow links, forum links, etc.

Diff for: .github/ISSUE_TEMPLATE/FEATURE_REQUEST.md

+12-9
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,12 @@ assignees: ""
88

99
## Feature Request
1010

11-
Thanks for showing an interest in continuing to grow this product! Please review the task list below
12-
before submitting the request. Your feature request will be closed if the information is incomplete
13-
and the below tasks are not completed.
11+
Thanks for showing an interest in continuing to grow this product! Please review
12+
the task list below before submitting the request. Your feature request will be
13+
closed if the information is incomplete and the below tasks are not completed.
1414

1515
## Task List
16+
1617
_Put an `x` in the boxes that apply_
1718

1819
- [ ] Describe the feature being requested
@@ -21,27 +22,29 @@ _Put an `x` in the boxes that apply_
2122

2223
**If the feature request is approved, would you be willing to submit a PR?**
2324
_(Help can be provided if you need assistance submitting a PR)_
25+
2426
- [ ] Yes
2527
- [ ] No
2628

2729
## Describe the Feature Request
2830

29-
Please provide a clear and concise description of what the feature request is. Please include if your
30-
feature request is related to a problem.
31+
Please provide a clear and concise description of what the feature request is.
32+
Please include if your feature request is related to a problem.
3133

3234
## Describe Preferred Solution
3335

3436
Provide a clear and concise description of what you want to happen.
3537

3638
## Describe Alternatives
3739

38-
If applicable, please provide a clear and concise description of any alternative solutions or features
39-
you've considered.
40+
If applicable, please provide a clear and concise description of any alternative
41+
solutions or features you've considered.
4042

4143
## Related Code
4244

43-
If you are able to illustrate the new feature request with an example, please provide it here.
45+
If you are able to illustrate the new feature request with an example, please
46+
provide it here.
4447

4548
## Further comments
4649

47-
Any other additional comments on the new feature can be added here.
50+
Any other additional comments on the new feature can be added here.

Diff for: .github/PULL_REQUEST_TEMPLATE.md

+17-7
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,35 @@
11
## Proposed changes
22

3-
Describe the big picture of your changes here to communicate to the maintainers why we should accept this pull request. If it fixes a bug or resolves a feature request, be sure to link to that issue.
3+
Describe the big picture of your changes here to communicate to the maintainers
4+
why we should accept this pull request. If it fixes a bug or resolves a feature
5+
request, be sure to link to that issue.
46

57
## Types of changes
68

7-
What types of changes does your code introduce?
8-
_Put an `x` in the boxes that apply_
9+
What types of changes does your code introduce? _Put an `x` in the boxes that
10+
apply_
911

1012
- [ ] Bugfix (non-breaking change which fixes an issue)
1113
- [ ] New feature (non-breaking change which adds functionality)
12-
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
14+
- [ ] Breaking change (fix or feature that would cause existing functionality to
15+
not work as expected)
1316

1417
## Checklist
1518

16-
_Put an `x` in the boxes that apply. You can also fill these out after creating the PR. If you're unsure about any of them, don't hesitate to ask. We're here to help! This is simply a reminder of what we are going to look for before merging your code._
19+
_Put an `x` in the boxes that apply. You can also fill these out after creating
20+
the PR. If you're unsure about any of them, don't hesitate to ask. We're here to
21+
help! This is simply a reminder of what we are going to look for before merging
22+
your code._
1723

18-
- [ ] I have read the [CONTRIBUTING](https://github.com/Optum/oss-template/blob/main/CONTRIBUTING.md) doc
24+
- [ ] I have read the
25+
[CONTRIBUTING](https://github.com/Optum/oss-template/blob/main/CONTRIBUTING.md)
26+
doc
1927
- [ ] I have added tests that prove my fix is effective or that my feature works
2028
- [ ] I have added necessary documentation (if appropriate)
2129
- [ ] Any dependent changes have been merged and published in downstream modules
2230

2331
## Further comments
2432

25-
If this is a relatively large or complex change, kick off the discussion by explaining why you chose the solution you did and what alternatives you considered, etc...
33+
If this is a relatively large or complex change, kick off the discussion by
34+
explaining why you chose the solution you did and what alternatives you
35+
considered, etc...

Diff for: CODE_OF_CONDUCT.md

+25-24
Original file line numberDiff line numberDiff line change
@@ -5,30 +5,30 @@
55
In the interest of fostering an open and welcoming environment, we as
66
contributors and maintainers pledge to making participation in our project and
77
our community a harassment-free experience for everyone, regardless of age, body
8-
size, disability, ethnicity, gender identity and expression, level of experience,
9-
nationality, personal appearance, race, religion, or sexual identity and
10-
orientation.
8+
size, disability, ethnicity, gender identity and expression, level of
9+
experience, nationality, personal appearance, race, religion, or sexual identity
10+
and orientation.
1111

1212
## Our Standards
1313

1414
Examples of behavior that contributes to creating a positive environment
1515
include:
1616

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

2323
Examples of unacceptable behavior by participants include:
2424

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
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
3030
address, without explicit permission
31-
* Other conduct which could reasonably be considered inappropriate in a
31+
- Other conduct which could reasonably be considered inappropriate in a
3232
professional setting
3333

3434
## Our Responsibilities
@@ -37,11 +37,11 @@ Project maintainers are responsible for clarifying the standards of acceptable
3737
behavior and are expected to take appropriate and fair corrective action in
3838
response to any instances of unacceptable behavior.
3939

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.
40+
Project maintainers have the right and responsibility to remove, edit, or reject
41+
comments, commits, code, wiki edits, issues, and other contributions that are
42+
not aligned to this Code of Conduct, or to ban temporarily or permanently any
43+
contributor for other behaviors that they deem inappropriate, threatening,
44+
offensive, or harmful.
4545

4646
## Scope
4747

@@ -58,18 +58,19 @@ Instances of abusive, harassing, or otherwise unacceptable behavior may be
5858
reported by contacting the project team at [[email protected]][email]. All
5959
complaints will be reviewed and investigated and will result in a response that
6060
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.
61+
obligated to maintain confidentiality with regard to the reporter of an
62+
incident. Further details of specific enforcement policies may be posted
63+
separately.
6364

6465
Project maintainers who do not follow or enforce the Code of Conduct in good
6566
faith may face temporary or permanent repercussions as determined by other
6667
members of the project's leadership.
6768

6869
## Attribution
6970

70-
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
71-
available at [http://contributor-covenant.org/version/1/4][version]
71+
This Code of Conduct is adapted from the [Contributor Covenant][homepage],
72+
version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
7273

7374
[homepage]: http://contributor-covenant.org
7475
[version]: http://contributor-covenant.org/version/1/4/
75-
[email]: mailto:[email protected]
76+
[email]: mailto:[email protected]

Diff for: CONTRIBUTING.md

+58-22
Original file line numberDiff line numberDiff line change
@@ -1,54 +1,90 @@
11
# Contribution Guidelines
22

3-
Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms. Please also review our [Contributor License Agreement ("CLA")](INDIVIDUAL_CONTRIBUTOR_LICENSE.md) prior to submitting changes to the project. You will need to attest to this agreement following the instructions in the [Paperwork for Pull Requests](#paperwork-for-pull-requests) section below.
3+
Please note that this project is released with a
4+
[Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this
5+
project you agree to abide by its terms. Please also review our
6+
[Contributor License Agreement ("CLA")](INDIVIDUAL_CONTRIBUTOR_LICENSE.md) prior
7+
to submitting changes to the project. You will need to attest to this agreement
8+
following the instructions in the
9+
[Paperwork for Pull Requests](#paperwork-for-pull-requests) section below.
410

511
---
612

713
# How to Contribute
814

9-
Now that we have the disclaimer out of the way, let's get into how you can be a part of our project. There are many different ways to contribute.
15+
Now that we have the disclaimer out of the way, let's get into how you can be a
16+
part of our project. There are many different ways to contribute.
1017

1118
## Issues
1219

13-
We track our work using Issues in GitHub. Feel free to open up your own issue to point out areas for improvement or to suggest your own new experiment. If you are comfortable with signing the waiver linked above and contributing code or documentation, grab your own issue and start working.
20+
We track our work using Issues in GitHub. Feel free to open up your own issue to
21+
point out areas for improvement or to suggest your own new experiment. If you
22+
are comfortable with signing the waiver linked above and contributing code or
23+
documentation, grab your own issue and start working.
1424

1525
## Coding Standards
1626

1727
We have some general guidelines towards contributing to this project.
1828

1929
### Languages
2030

21-
*Lua*
31+
_Lua_
2232

2333
## Pull Requests
2434

25-
If you've gotten as far as reading this section, then thank you for your suggestions.
35+
If you've gotten as far as reading this section, then thank you for your
36+
suggestions.
2637

2738
## Paperwork for Pull Requests
2839

29-
* Please read this guide and make sure you agree with our [Contributor License Agreement ("CLA")](INDIVIDUAL_CONTRIBUTOR_LICENSE.md).
30-
* Make sure git knows your name and email address:
31-
```
32-
$ git config user.name "J. Random User"
33-
$ git config user.email "[email protected]"
34-
```
35-
>The name and email address must be valid as we cannot accept anonymous contributions.
36-
* Write good commit messages.
37-
> Concise commit messages that describe your changes help us better understand your contributions.
38-
* The first time you open a pull request in this repository, you will see a comment on your PR with a link that will allow you to sign our Contributor License Agreement (CLA) if necessary.
39-
> The link will take you to a page that allows you to view our CLA. You will need to click the `Sign in with GitHub to agree button` and authorize the cla-assistant application to access the email addresses associated with your GitHub account. Agreeing to the CLA is also considered to be an attestation that you either wrote or have the rights to contribute the code. All committers to the PR branch will be required to sign the CLA, but you will only need to sign once. This CLA applies to all repositories in the Optum org.
40+
- Please read this guide and make sure you agree with our
41+
[Contributor License Agreement ("CLA")](INDIVIDUAL_CONTRIBUTOR_LICENSE.md).
42+
- Make sure git knows your name and email address:
43+
```
44+
$ git config user.name "J. Random User"
45+
$ git config user.email "[email protected]"
46+
```
47+
48+
> The name and email address must be valid as we cannot accept anonymous
49+
> contributions.
50+
51+
- Write good commit messages.
52+
53+
> Concise commit messages that describe your changes help us better understand
54+
> your contributions.
55+
56+
- The first time you open a pull request in this repository, you will see a
57+
comment on your PR with a link that will allow you to sign our Contributor
58+
License Agreement (CLA) if necessary.
59+
60+
> The link will take you to a page that allows you to view our CLA. You will
61+
> need to click the `Sign in with GitHub to agree button` and authorize the
62+
> cla-assistant application to access the email addresses associated with your
63+
> GitHub account. Agreeing to the CLA is also considered to be an attestation
64+
> that you either wrote or have the rights to contribute the code. All
65+
> committers to the PR branch will be required to sign the CLA, but you will
66+
> only need to sign once. This CLA applies to all repositories in the Optum org.
4067
4168
## General Guidelines
4269

4370
Ensure your pull request (PR) adheres to the following guidelines:
4471

45-
* Try to make the name concise and descriptive.
46-
* Give a good description of the change being made. Since this is very subjective, see the [Updating Your Pull Request (PR)](#updating-your-pull-request-pr) section below for further details.
47-
* Every pull request should be associated with one or more issues. If no issue exists yet, please create your own.
48-
* Make sure that all applicable issues are mentioned somewhere in the PR description. This can be done by typing # to bring up a list of issues.
72+
- Try to make the name concise and descriptive.
73+
- Give a good description of the change being made. Since this is very
74+
subjective, see the
75+
[Updating Your Pull Request (PR)](#updating-your-pull-request-pr) section
76+
below for further details.
77+
- Every pull request should be associated with one or more issues. If no issue
78+
exists yet, please create your own.
79+
- Make sure that all applicable issues are mentioned somewhere in the PR
80+
description. This can be done by typing # to bring up a list of issues.
4981

5082
### Updating Your Pull Request (PR)
5183

52-
A lot of times, making a PR adhere to the standards above can be difficult. If the maintainers notice anything that we'd like changed, we'll ask you to edit your PR before we merge it. This applies to both the content documented in the PR and the changed contained within the branch being merged. There's no need to open a new PR. Just edit the existing one.
84+
A lot of times, making a PR adhere to the standards above can be difficult. If
85+
the maintainers notice anything that we'd like changed, we'll ask you to edit
86+
your PR before we merge it. This applies to both the content documented in the
87+
PR and the changed contained within the branch being merged. There's no need to
88+
open a new PR. Just edit the existing one.
5389

54-
[email]: mailto:[email protected]
90+
[email]: mailto:[email protected]

0 commit comments

Comments
 (0)