Skip to content

Commit

Permalink
Merge pull request #4 from wayfair/add-initial-repo-content
Browse files Browse the repository at this point in the history
Add initial repo content
  • Loading branch information
lelia authored Apr 11, 2022
2 parents f82ac7f + ed5388c commit fc5baea
Show file tree
Hide file tree
Showing 9 changed files with 41 additions and 56 deletions.
3 changes: 1 addition & 2 deletions .github/ISSUE_TEMPLATE/BUG_REPORT.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,5 @@ Please provide the version number where this issue was encountered.

## Checklist

<!-- TODO: Update the link below to point to your project's contributing guidelines -->
- [ ] I have read the [contributing guidelines](https://github.com/wayfair-incubator/oss-template/blob/main/CONTRIBUTING.md)
- [ ] I have read the [contributing guidelines](https://github.com/wayfair/ospo-automation/blob/main/CONTRIBUTING.md)
- [ ] I have verified this does not duplicate an existing issue
3 changes: 1 addition & 2 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,7 @@ Note that by _not_ including a description, you are asking reviewers to do extra

## Checklist

<!-- TODO: Update the link below to point to your project's contributing guidelines -->
- [ ] I have read the [contributing guidelines](https://github.com/wayfair-incubator/oss-template/blob/main/CONTRIBUTING.md)
- [ ] I have read the [contributing guidelines](https://github.com/wayfair/ospo-automation/blob/main/CONTRIBUTING.md)
- [ ] Existing issues have been referenced (where applicable)
- [ ] I have verified this change is not present in other open pull requests
- [ ] Functionality is documented
Expand Down
1 change: 1 addition & 0 deletions .github/workflows/lint.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ on: # Rebuild any PRs and main branch changes
branches:
- main
pull_request:
workflow_dispatch:

jobs:
lint:
Expand Down
12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.2.0] - 2022-04-06

### Added

- Contact information for project
- Project URLs for repository templates
- License file README references

### Changed

- Placeholders from initial repository template content

## [0.1.0] - 2022-04-05

### Added
Expand Down
2 changes: 1 addition & 1 deletion CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ representative at an online or offline event.

Instances of abusive, harassing, or otherwise unacceptable behavior may be
reported to the community leaders responsible for enforcement at
[INSERT CONTACT METHOD].
OpenSource@Wayfair.com.
All complaints will be reviewed and investigated promptly and fairly.

All community leaders are obligated to respect the privacy and security of the
Expand Down
12 changes: 6 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# How to Contribute

Thanks for your interest in contributing to `<project name>`! Here are a few general guidelines on contributing and
Thanks for your interest in contributing to OSPO Automation! Here are a few general guidelines on contributing and
reporting bugs that we ask you to review. Following these guidelines helps to communicate that you respect the time of
the contributors managing and developing this open source project. In return, they should reciprocate that respect in
addressing your issue, assessing changes, and helping you finalize your pull requests. In that spirit of mutual respect,
Expand All @@ -14,7 +14,7 @@ any real-time space (eg. Slack, Discord, etc).
## Reporting Issues

Before reporting a new issue, please ensure that the issue was not already reported or fixed by searching through our
[issues list](https://github.com/org_name/repo_name/issues).
[issues list](https://github.com/wayfair/ospo-automation/issues).

When creating a new issue, please be sure to include a **title and clear description**, as much relevant information as
possible, and, if possible, a test case.
Expand All @@ -32,16 +32,16 @@ reserve breaking changes until the next major version release.

## Other Ways to Contribute

We welcome anyone that wants to contribute to `<project name>` to triage and reply to open issues to help troubleshoot
We welcome anyone that wants to contribute to OSPO Automation to triage and reply to open issues to help troubleshoot
and fix existing bugs. Here is what you can do:

- Help ensure that existing issues follows the recommendations from the _[Reporting Issues](#reporting-issues)_ section,
providing feedback to the issue's author on what might be missing.
- Review and update the existing content of our [Wiki](https://github.com/org_name/repo_name/wiki) with up-to-date
- Review and update the existing content of our [Wiki](https://github.com/wayfair/ospo-automation/wiki) with up-to-date
instructions and code samples.
- Review existing pull requests, and testing patches against real existing applications that use `<project name>`.
- Review existing pull requests, and testing patches against real existing applications that use OSPO Automation.
- Write a test, or add a missing test case to an existing test.

Thanks again for your interest on contributing to `<project name>`!
Thanks again for your interest on contributing to OSPO Automation!

:heart:
4 changes: 1 addition & 3 deletions MAINTAINERS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
# Maintainers

- [GitHub Username](https://github.com/username)
- [GitHub Username](https://github.com/username)
- [GitHub Username](https://github.com/username)
[![GitHub](https://img.shields.io/badge/github.com/wayfair-%23121011.svg?style=for-the-badge&logo=github&logoColor=white)](https://github.com/wayfair)
50 changes: 13 additions & 37 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,39 +1,14 @@
# Open Source Project Template
# OSPO Automation

[![Release](https://img.shields.io/badge/release-v0.0.1-blue.svg)](CHANGELOG.md)
[![Release](https://img.shields.io/badge/release-v0.0.2-blue.svg)](CHANGELOG.md)
[![Lint](https://github.com/wayfair/ospo-automation/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/wayfair/ospo-automation/actions/workflows/lint.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-orange.svg)](LICENSE)
[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.0-4baaaa.svg)](CODE_OF_CONDUCT.md)
[![Maintainer](https://img.shields.io/badge/Maintainer-Wayfair-7F187F)](https://wayfair.github.io)

## Before You Start

As much as possible, we have tried to provide enough tooling to get you up and running quickly and with a minimum of effort. This includes sane defaults for documentation; templates for bug reports, feature requests, and pull requests; and [GitHub Actions](https://github.com/features/actions) that will automatically manage stale issues and pull requests. This latter defaults to labeling issues and pull requests as stale after 60 days of inactivity, and closing them after 7 additional days of inactivity. These [defaults](.github/workflows/stale.yml) and more can be configured. For configuration options, please consult the documentation for the [stale action](https://github.com/actions/stale).

In trying to keep this template as generic and reusable as possible, there are some things that were omitted out of necessity and others that need a little tweaking. Before you begin developing in earnest, there are a few changes that need to be made.

- [ ] Select an appropriate license for your project. This can easily be achieved through the 'Add File' button on the GitHub UI, naming the file `LICENSE`, and selecting your desired license from the provided list.
- [ ] Update the `<License name>` placeholder in this file to reflect the name of the license you selected above
- [ ] Replace `[INSERT CONTACT METHOD]` in [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) with a suitable communication channel
- [ ] Change references to `org_name` to the name of the org your repo belongs to (eg. `wayfair-incubator`)
- [ ] In [`README.md`](README.md)
- [ ] In [`CONTRIBUTING.md`](CONTRIBUTING.md)
- [ ] Change references to `repo_name` to the name of your new repo
- [ ] In [`README.md`](README.md)
- [ ] In [`CONTRIBUTING.md`](CONTRIBUTING.md)
- [ ] Update the link to the contribution guidelines to point to your project
- [ ] In [`.github/ISSUE_TEMPLATE/BUG_REPORT.md`](.github/ISSUE_TEMPLATE/BUG_REPORT.md)
- [ ] In [`.github/PULL_REQUEST_TEMPLATE.md`](.github/PULL_REQUEST_TEMPLATE.md)
- [ ] Replace the `<project name>` placeholder with the name of your project
- [ ] In [`CONTRIBUTING.md`](CONTRIBUTING.md)
- [ ] In [`SECURITY.md`](SECURITY.md)
- [ ] Add names and contact information for actual project maintainers to [`MAINTAINERS.md`](MAINTAINERS.md)
- [ ] Delete the content of [`CHANGELOG.md`](CHANGELOG.md). We encourage you to [keep a changelog](https://keepachangelog.com/en/1.0.0/).
- [ ] Replace the generic content in this file with the relevant details about your project
- [ ] Delete this section of the README

## About The Project

Provide some information about what the project is/does.
Automation workflows for Wayfair's [Open Source Program Office](https://wayfair.github.io).

## Getting Started

Expand All @@ -54,7 +29,7 @@ This is an example of how to list things you need to use the software and how to
1. Clone the repo

```sh
git clone https://github.com/org_name/repo_name.git
git clone https://github.com/wayfair/ospo-automation.git
```

2. Install NPM packages
Expand All @@ -67,27 +42,28 @@ This is an example of how to list things you need to use the software and how to

Use this space to show useful examples of how a project can be used. Additional screenshots, code examples and demos work well in this space. You may also link to more resources.

_For more examples, please refer to the [Documentation](https://example.com) or the [Wiki](https://github.com/org_name/repo_name/wiki)_
_For more examples, please refer to the [Documentation](https://wayfair.github.io) or the [Wiki](https://github.com/wayfair/ospo-automation/wiki)_

## Roadmap

See the [open issues](https://github.com/org_name/repo_name/issues) for a list of proposed features (and known issues).
See the [open issues](https://github.com/wayfair/ospo-automation/issues) for a list of proposed features (and known issues).

## Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**. For detailed contributing guidelines, please see [CONTRIBUTING.md](CONTRIBUTING.md)

## License

Distributed under the `<License name>` License. See `LICENSE` for more information.
Distributed under the MIT License. See [LICENSE](LICENSE) for more information.

## Contact

Your Name - [@twitter_handle](https://twitter.com/twitter_handle) - email
[![Gmail](https://img.shields.io/badge/OpenSource@wayfair.com-D14836?style=for-the-badge&logo=gmail&logoColor=white)](mailto:OpenSource@wayfair.com)

[![Gatsby](https://img.shields.io/badge/wayfair.github.io-%23663399.svg?style=for-the-badge&logo=gatsby&logoColor=white)](https://wayfair.github.io)

Project Link: [https://github.com/org_name/repo_name](https://github.com/org_name/repo_name)
[![Twitter](https://img.shields.io/badge/wayfairtech-%231DA1F2.svg?style=for-the-badge&logo=Twitter&logoColor=white)](https://twitter.com/wayfairtech)

## Acknowledgements

This template was adapted from
[https://github.com/othneildrew/Best-README-Template](https://github.com/othneildrew/Best-README-Template).
[Repository template](https://github.com/wayfair-incubator/oss-template) made with 💜 by Wayfair's [Open Source Program Office](https://wayfair.github.io).
10 changes: 5 additions & 5 deletions SECURITY.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
# Security Policies and Procedures

This document outlines security procedures and general policies for the
`<project name>` project.
OSPO Automation project.

- [Reporting a Bug](#reporting-a-bug)
- [Disclosure Policy](#disclosure-policy)
- [Comments on this Policy](#comments-on-this-policy)

## Reporting a Bug

The `<project name>` team and community take all security bugs in
`<project name>` seriously. Thank you for improving the security of
`<project name>`. We appreciate your efforts and responsible disclosure and
The Wayfair Open Source team and community take all security bugs in
OSPO Automation seriously. Thank you for improving the security of
OSPO Automation. We appreciate your efforts and responsible disclosure and
will make every effort to acknowledge your contributions.

Report security bugs by emailing `OpenSource@wayfair.com`.
Report security bugs by emailing OpenSource@wayfair.com.

The lead maintainer will acknowledge your email within 48 hours, and will send a
more detailed response within 48 hours indicating the next steps in handling
Expand Down

0 comments on commit fc5baea

Please sign in to comment.