Skip to content

Commit 4e4a240

Browse files
committed
Update files according to Contributors library guidelines.
1 parent 00a8435 commit 4e4a240

File tree

9 files changed

+68
-71
lines changed

9 files changed

+68
-71
lines changed

.github/ISSUE_TEMPLATE/bug-report.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ assignees: ""
77
---
88

99
**Describe the bug**
10-
A clear and concise description of what the bug is.
10+
A clear and concise description of the bug.
1111

1212
**To Reproduce**
1313
A minimal code example (preferably a runnable example on [Try PureScript](https://try.purescript.org)!) or steps to reproduce the issue.

.github/ISSUE_TEMPLATE/change-request.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
name: Change request
33
about: Propose an improvement to this library
44
title: ""
5-
labels: enhancement
5+
labels: ""
66
assignees: ""
77
---
88

99
**Is your change request related to a problem? Please describe.**
10-
A clear and concise description of what the problem is.
10+
A clear and concise description of the problem.
1111

1212
Examples:
1313

.github/contributing.md

Lines changed: 3 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,5 @@
1-
# Contributing
1+
# Contributing to Argonaut Codecs
22

3-
Thanks for your interest in contributing to argonaut-codecs! This file is a short, sweet introduction to contributing to this project. We ask that all new contributors read it before their first contribution to make sure we can get your work merged.
3+
Thanks for your interest in contributing to `argonaut-codecs`! We welcome new contributions regardless of your level of experience or familiarity with PureScript.
44

5-
## Getting Started
6-
7-
### Do I belong here?
8-
9-
Everyone is welcome! People of all experience levels can join, begin contributing, and feel comfortable and safe making mistakes. People of all backgrounds belong here so long as they treat others with dignity and respect and do not harass, belittle, or insult others.
10-
11-
### What is the correct way to ask a question?
12-
13-
Feel free to ask questions by [opening an issue](https://github.com/purescript-contrib/purescript-argonaut-codecs/issues)! You can also ask questions on the [PureScript Discourse](https://discourse.purescript.org), or on the [Functional Programming Slack](https://functionalprogramming.slack.com) ([join](https://fpchat-invite.herokuapp.com)!) in the `#purescript` and `#purescript-beginners` channels.
14-
15-
### I'd like to help, how do I pick something to work on?
16-
17-
Any [open issue](https://github.com/purescript-contrib/purescript-argonaut-codecs/issues) that is not assigned to anyone is good to work on! If it's your first time contributing it's probably best to pick an issue marked [good first issue](https://github.com/purescript-contrib/purescript-argonaut-codecs/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue). You can also search for issues marked [help-wanted](https://github.com/purescript-contrib/purescript-argonaut-codecs/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted).
18-
19-
The easiest way you can help is by contributing documentation (issues marked [document me](https://github.com/purescript-contrib/purescript-argonaut-codecs/issues?q=is%3Aissue+is%3Aopen+label%3A%22document+me). If you'd like to contribute documentation, we suggest [reading about the four kinds of documentation](https://documentation.divio.com).
20-
21-
Your contribution can be as small as copy-pasting some instructions from an issue into the documentation! Everything is welcome.
22-
23-
## Developing argonaut-codecs
24-
25-
All `purescript-contrib` libraries use recent versions of [PureScript](https://github.com/purescript/purescript), [Spago](https://github.com/purescript/spago), and [psa](https://github.com/natefaubion/purescript-psa). Any additional development dependencies can be installed via NPM and are listed in the `package.json` file for the repository.
26-
27-
### Proposing changes
28-
29-
If you would like to contribute code, tests, or documentation, please feel free to open a pull request for small changes. For large changes we recommend you first open an issue to propose your change and ensure that the maintainers are on board before you spend time implementing the change. We want to respect your time and effort. We can also assign the issue to you if you would like to make sure you're the one to work on it.
30-
31-
### Merging changes
32-
33-
All changes must happen through a pull request. Everyone with commit access can merge changes, though by convention we like to wait for two approvals for non-trivial changes. All pull requests must pass continuous integration; if the change adds new code we may also ask that you add a test.
34-
35-
## How do I get the "commit bit"?
36-
37-
If you'd like to take part in maintaining argonaut-codecs, just ask! We hand out the commit bit to folks who display sustained interest in the project. You can ask directly (for example: on Slack or via a DM on Discourse) or by opening an issue -- whichever you prefer!
5+
Every library in the Contributors organization shares a simple handbook that helps new contributors get started. With that in mind, please [read the short contributing guide on purescript-contrib/governance](https://github.com/purescript-contrib/governance/blob/main/contributing.md) before contributing to this library.

.github/pull_request_template.md

Lines changed: 8 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,11 @@
1-
## What does this pull request do?
1+
**Description of the change**
2+
Clearly and concisely describe the purpose of the pull request. If this PR relates to an existing issue or change proposal, please link to it. Include any other background context that would help reviewers understand the motivation for this PR.
23

3-
Please describe the purpose of the pull request, including any background context and links to related issues. If this introduces a large change to the project, please describe what you have implemented.
4+
---
45

5-
## Where should the reviewer start?
6+
**Checklist:**
67

7-
Help save the reviewer time by highlighting the most important sections of code.
8-
9-
## How should this be manually tested?
10-
11-
If this is a new feature, you should provide new test coverage. If it fixes an existing bug, you should provide a failing test case this change fixes. Other than automated testing, what manual tests can the reviewer perform to verify your work?
12-
13-
## Other Notes:
14-
15-
Does the project documentation need to be updated? Should we introduce a new example, or update any existing examples? Does this PR require any other follow-up tasks?
8+
- [ ] Added the change to the changelog's "Unreleased" section with a link to this PR and your username
9+
- [ ] Linked any existing issues or proposals that this pull request should close
10+
- [ ] Updated or added relevant documentation in the README and/or documentation directory
11+
- [ ] Added a test for the contribution (if applicable)

.github/workflows/ci.yml

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,19 @@ name: CI
22

33
on:
44
push:
5-
branches: [master]
5+
branches: [main]
66
pull_request:
7-
branches: [master]
7+
branches: [main]
88

99
jobs:
1010
build:
1111
runs-on: ubuntu-latest
1212

1313
steps:
1414
- uses: actions/checkout@v2
15-
- uses: thomashoneyman/setup-purescript@main
15+
16+
- name: Set up a PureScript toolchain
17+
uses: purescript-contrib/setup-purescript@main
1618

1719
- name: Cache PureScript dependencies
1820
uses: actions/cache@v2
@@ -22,8 +24,11 @@ jobs:
2224
.spago
2325
output
2426
27+
- name: Install dependencies
28+
run: spago install
29+
2530
- name: Build source
26-
run: spago build
31+
run: spago build --no-install --purs-args '--censor-lib --strict'
2732

2833
- name: Run tests
2934
run: spago test --no-install

.github/workflows/stale.yml

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
name: "Stale"
2+
3+
on:
4+
schedule:
5+
- cron: "0 0 * * *"
6+
7+
jobs:
8+
stale:
9+
runs-on: ubuntu-latest
10+
steps:
11+
- uses: actions/stale@v3
12+
env:
13+
days-until-stale: 60
14+
days-until-close: 14
15+
with:
16+
repo-token: ${{ secrets.GITHUB_TOKEN }}
17+
stale-issue-message: "This issue is stale because it has been open for ${{ env.days-until-stale }} days with no activity. Remove the stale label or comment to keep this issue open. Otherwise, this issue will be closed in ${{ env.days-until-close }} days."
18+
stale-pr-message: "This pull request is stale because it has been open for ${{ env.days-until-stale }} days with no activity. Remove the stale label or comment to keep this pull request open. Otherwise, this pull request will be closed in ${{ env.days-until-close }} days."
19+
days-before-stale: ${{ env.days-until-stale }}
20+
days-before-close: ${{ env.days-until-close }}
21+
stale-issue-label: "stale"
22+
stale-pr-label: "stale"
23+
exempt-pr-labels: "breaking change"

.gitignore

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,7 @@
11
.*
22
!.gitignore
33
!.github
4-
!.eslintrc.json
54
!.editorconfig
65

7-
# Dependencies
8-
bower_components
9-
node_modules
10-
11-
# Generated files
126
output
137
generated-docs
14-
15-
# Non-NPM lockfiles
16-
*.lock

README.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
11
# Argonaut Codecs
22

3-
[![CI](https://github.com/purescript-contrib/purescript-argonaut-codecs/workflows/CI/badge.svg?branch=master)](https://github.com/purescript-contrib/purescript-argonaut-codecs/actions?query=workflow%3ACI+branch%3Amaster)
3+
[![CI](https://github.com/purescript-contrib/purescript-argonaut-codecs/workflows/CI/badge.svg?branch=main)](https://github.com/purescript-contrib/purescript-argonaut-codecs/actions?query=workflow%3ACI+branch%3Amain)
44
[![Release](http://img.shields.io/github/release/purescript-contrib/purescript-argonaut-codecs.svg)](https://github.com/purescript-contrib/purescript-argonaut-codecs/releases)
55
[![Pursuit](http://pursuit.purescript.org/packages/purescript-argonaut-codecs/badge)](http://pursuit.purescript.org/packages/purescript-argonaut-codecs)
6-
[![Maintainer: garyb](https://img.shields.io/badge/maintainer-garyb-teal.svg)](http://github.com/garyb)
76
[![Maintainer: thomashoneyman](https://img.shields.io/badge/maintainer-thomashoneyman-teal.svg)](http://github.com/thomashoneyman)
87

98
[Argonaut](https://github.com/purescript-contrib/purescript-argonaut) is a collection of libraries for working with JSON in PureScript. `argonaut-codecs` provides codecs based on the `EncodeJson` and `DecodeJson` type classes, along with instances for common data types and combinators for encoding and decoding `Json` values.
@@ -19,13 +18,13 @@ The quick start will get you up and running with the basics of `argonaut-codecs`
1918

2019
## Installation
2120

22-
Install with [Spago](https://github.com/purescript/spago):
21+
Install `argonaut-codecs` with [Spago](https://github.com/purescript/spago):
2322

2423
```sh
2524
spago install argonaut-codecs
2625
```
2726

28-
or install as part of the [Argonaut](https://github.com/purescript-contrib/purescript-argonaut) bundle:
27+
or install it as part of the [Argonaut](https://github.com/purescript-contrib/purescript-argonaut) bundle:
2928

3029
```sh
3130
spago install argonaut
@@ -71,11 +70,11 @@ Left "An error occurred while decoding a JSON value:\n At object key 'age':\n
7170

7271
## Documentation
7372

74-
You can find `argonaut-codecs` documentation in a few places:
73+
`argonaut-codecs` documentation is stored in a few places:
7574

7675
1. Module documentation is [published on Pursuit](https://pursuit.purescript.org/packages/purescript-argonaut-codecs).
77-
2. The tutorial and other written documentation is kept in [the docs directory](./docs).
78-
3. Additional usage examples can be found in [the PureScript Cookbook](https://github.com/JordanMartinez/purescript-cookbook)
76+
2. Written documentation and [the changelog](./docs/CHANGELOG.md) are kept in [the docs directory](./docs).
77+
3. Usage examples can be found in [the test suite](./test).
7978

8079
If you get stuck, there are several ways to get help:
8180

@@ -86,7 +85,7 @@ If you get stuck, there are several ways to get help:
8685

8786
You can contribute to `argonaut-codecs` in several ways:
8887

89-
1. If you encounter a problem or have a question, please [open an issue](https://github.com/purescript-contrib/purescript-argonaut-codecs/issues) issue. We'll do our best to work with you to resolve or answer it.
88+
1. If you encounter a problem or have a question, please [open an issue](https://github.com/purescript-contrib/purescript-argonaut-codecs/issues). We'll do our best to work with you to resolve or answer it.
9089

9190
2. If you would like to contribute code, tests, or documentation, please [read the contributor guide](./.github/CONTRIBUTING.md). It's a short, helpful introduction to contributing to this library, including development instructions.
9291

docs/CHANGELOG.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Changelog
2+
3+
Notable changes to this project are 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).
4+
5+
## [Unreleased]
6+
7+
Breaking changes (😱!!!):
8+
9+
New features:
10+
11+
Bugfixes:
12+
13+
Other improvements:
14+
15+
## [0.0.0] - 2020-01-01

0 commit comments

Comments
 (0)