.github/workflows/lint.yml

@@ -0,0 +1,27 @@
+name: lint
+
+on: # Rebuild any PRs and main branch changes
+  push:
+    branches:
+      - main
+      - develop
+  pull_request:
+
+jobs:
+  markdown:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: ⬇️ lint markdown files # Lints all markdown (.md) files
+        uses: avto-dev/markdown-lint@v1
+        with:
+          config: '.markdownlint.json'
+          args: '**/*.md .github/**/*.md'
+  renovate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: 🧼 lint renovate config # Validates changes to renovate.json config file
+        uses: suzuki-shunsuke/github-action-renovate-config-validator@v1.1.1
+        with:
+          config_file_path: 'renovate.json'

.github/workflows/stale.yml

@@ -1,4 +1,4 @@
-name: Identify and close stale issues and pull requests
+name: stale
 
 on:
   schedule:
@@ -10,9 +10,9 @@ jobs:
     permissions:
       issues: write
       pull-requests: write
-
     steps:
-    - uses: actions/stale@v3
+    - name: 📆 mark stale PRs # Automatically marks inactive PRs as stale
+      uses: actions/stale@v9
       with:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
         days-before-stale: 60

.markdownlint.json

@@ -9,5 +9,8 @@
     "MD024": {
         "siblings_only": true
     },
+    "MD025": {
+        "front_matter_title": ""
+    },
     "MD041": false
 }

CHANGELOG.md

@@ -5,6 +5,56 @@ 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).
 
+## [Unreleased]
+
+### TBA
+
+## [0.3.9] - 2022-11-08
+
+### Changed
+
+- Leveraging [hosted presets](https://docs.renovatebot.com/config-presets/) for `renovate.json` config
+
+## [0.3.8] - 2022-08-15
+
+### Added
+
+- Recommended configuration for [renovate](https://github.com/renovatebot/renovate)
+- Linting workflow for `renovate.json` config
+
+### Changed
+
+- Pinned v4 of [github-pages-deploy-action](https://github.com/marketplace/actions/deploy-to-github-pages)
+- Removed [dependabot](https://github.com/dependabot) configuration
+
+## [0.3.7] - 2022-04-04
+
+### Changed
+
+- Update lint workflow trigger behavior
+
+## [0.3.6] - 2022-03-22
+
+### Added
+
+- Adds new template badges to README
+
+### Changed
+
+- Bumps [actions/checkout](https://github.com/marketplace/actions/checkout) from v2 to v3
+
+## [0.3.5] - 2021-10-21
+
+### Added
+
+- Add step to update contact information in Code of Conduct
+
+## [0.3.4] - 2021-10-19
+
+### Added
+
+- Dependabot configuration
+
 ## [0.3.3] - 2021-10-07
 
 ### Added
@@ -67,3 +117,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Maintainers file
 - README template
 - Security guidance
+
+[unreleased]: https://github.com/wayfair-incubator/oss-template/compare/v0.3.9...HEAD
+[0.3.9]: https://github.com/wayfair-incubator/oss-template/compare/v0.3.8...v0.3.9
+[0.3.8]: https://github.com/wayfair-incubator/oss-template/compare/v0.3.7...v0.3.8
+[0.3.7]: https://github.com/wayfair-incubator/oss-template/compare/v0.3.6...v0.3.7
+[0.3.6]: https://github.com/wayfair-incubator/oss-template/compare/v0.3.5...v0.3.6
+[0.3.5]: https://github.com/wayfair-incubator/oss-template/compare/v0.3.4...v0.3.5
+[0.3.4]: https://github.com/wayfair-incubator/oss-template/compare/v0.3.3...v0.3.4
+[0.3.3]: https://github.com/wayfair-incubator/oss-template/compare/v0.3.2...v0.3.3
+[0.3.2]: https://github.com/wayfair-incubator/oss-template/compare/v0.3.1...v0.3.2
+[0.3.1]: https://github.com/wayfair-incubator/oss-template/compare/v0.3.0...v0.3.1
+[0.3.0]: https://github.com/wayfair-incubator/oss-template/compare/v0.2.1...v0.3.0
+[0.2.1]: https://github.com/wayfair-incubator/oss-template/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/wayfair-incubator/oss-template/compare/v0.1.1...v0.2.0
+[0.1.1]: https://github.com/wayfair-incubator/oss-template/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/wayfair-incubator/oss-template/releases/tag/v0.1.0

README.md

@@ -1,32 +1,39 @@
-# OSPO Project Template
+# Open Source Project Template
 
-[![OSS Template Version](https://img.shields.io/badge/OSS%20Template-0.3.3-7f187f.svg)](https://github.com/wayfair-incubator/oss-template/blob/main/CHANGELOG.md)
+[![Release](https://img.shields.io/github/v/release/wayfair-incubator/oss-template?display_name=tag)](CHANGELOG.md)
+[![Lint](https://github.com/wayfair-incubator/oss-template/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/wayfair-incubator/oss-template/actions/workflows/lint.yml)
 [![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.
+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
-- [ ] Change references to `org_name` to the name of the org your repo belongs to (eg. `wayfair-incubator`)
+- [ ] ✅ 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
+- [ ] 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
+- [ ] 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
+- [ ] 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 encourgage 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
+- [ ] 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/).
+- [ ] Configure [`renovate.json`](renovate.json) for your project's language and tooling dependencies.
+  - [ ] Note that the base `renovate.json` file included with this template inherits most of its configuration logic from Wayfair OSPO's recommended presets, hosted [here](https://github.com/wayfair/ospo-automation/blob/main/default.json). If your project does not require advanced dependency configuration, this may be sufficient for your needs.
+  - [ ] 💡 To learn more about using and configuring [Renovate](http://renovatebot.com/), check out our [wayfair.github.io](https://wayfair.github.io) article: **[Managing Project Dependencies](https://wayfair.github.io/docs/managing-dependencies/)**.
+- [ ] Replace the generic content in this file with the relevant details about your project.
+- [ ] Acknowledge that some features like [branch protection rules](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule) are only available when the repo is `public`.
+- [ ] 🚨 Delete this section of the `README`!
 
 ## About The Project
 
@@ -76,7 +83,7 @@ Contributions are what make the open source community such an amazing place to l
 
 ## License
 
-Distributed under the `<License name>` License. See `LICENSE` for more information.
+Distributed under the `<License name>` License. See [LICENSE](LICENSE) for more information.
 
 ## Contact
 
@@ -86,5 +93,5 @@ Project Link: [https://github.com/org_name/repo_name](https://github.com/org_nam
 
 ## Acknowledgements
 
-This template adapted from
-[https://github.com/othneildrew/Best-README-Template](https://github.com/othneildrew/Best-README-Template)
+This template was adapted from
+[https://github.com/othneildrew/Best-README-Template](https://github.com/othneildrew/Best-README-Template).

renovate.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "description": "Wayfair OSPO recommended presets (https://github.com/wayfair/ospo-automation/blob/main/default.json)",
+  "extends": [
+    "github>wayfair/ospo-automation"
+  ]
+}