From a2cd7bdcba2c7ef19a1516cbd309da69b757fc6d Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Thu, 13 Oct 2022 09:48:04 +0100 Subject: [PATCH 1/9] Add a 'current-work' location to allow people to highlight current areas of focus or interest Resolves https://github.com/json-schema-org/community/issues/249 --- current-work/README.md | 44 ++++++++++++++++++++++++++++++++++++++++ current-work/the-list.md | 14 +++++++++++++ 2 files changed, 58 insertions(+) create mode 100644 current-work/README.md create mode 100644 current-work/the-list.md diff --git a/current-work/README.md b/current-work/README.md new file mode 100644 index 00000000..82090f08 --- /dev/null +++ b/current-work/README.md @@ -0,0 +1,44 @@ +# The JSON Schema Organization's areas of focus or interest + +## About +### What is this space? + +During an [Open Community Working Meeting](https://github.com/json-schema-org/community/issues/244), it was suggested that we could have a place for the core team (and maybe active community members?) to log their current areas of focus or interest in the form of GitHub Issues, Pull Requests, and Discussions. + +### Why? + +We concluded there was a LOT of activity taking place, and it was hard to get people to focus on the "important things". It is indeed hard to focus on priority items when there are many new GitHub Issues and Discussions each week, especially for those who are community members or not working on JSON Schema full or even part time. It was suggested that by asking for one to three items of priority, we might find it easier to draw attention where we feel it is needed. + +### How? + +The process will initially be manual and require people to commit to the adjacent file which contains the list. +The list will be used as it is found on Friday to help assist populate the following Monday's Open Community Working Meeting agenda. +We may introduce automations to assist in this at a later point, or a medium that isn't storing data in a text file. + +#### How should the file be updated? + +Initially, only those who are actively contributing should look at add items to the list. +To add items to the list, either make commits directly, or make a PR and then nudge someone to approve it. +If you'd like permission to commit to the repo, please do ask. + +If you're adding to the list for the first time, please copy the below template, and add your GitHub username in alphabetical order. + + + Show/hide template + +```md + Link: [Link to Github Issue, Pull Request, or Discussion] + What?: [The most simplest basic explanation of what the thing is about. Think a single tweets length or less.] + Why does it matter?: [Pitch why people should care about this too. Why do you care about it?] + What can we do?: [What would you like us to do in relation to this thing?] +``` + + + +### Show me the details + +OK! Great! You want [the-list.md](./the-list.md) + +## More? + +@relequestual had some ideas on how automation could make this easier to use and encourage engagement, but it lead to a rabbit hole of questions and looking at docs and there wasn't any low-hanging fruit to be had. He intends to write up some suggestions on this soon. \ No newline at end of file diff --git a/current-work/the-list.md b/current-work/the-list.md new file mode 100644 index 00000000..82a16563 --- /dev/null +++ b/current-work/the-list.md @@ -0,0 +1,14 @@ +# The JSON Schema Organization's areas of focus or interest + +## What is this document? + +Please see the adjacent [README](./README.md). + +## The lists of things + +### @relequestual + +Link : +What? : +Why does it matter? : +What can people do? : From d8e088936ac39d57bd4581737e716c08aa7c2596 Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Thu, 13 Oct 2022 10:00:55 +0100 Subject: [PATCH 2/9] Add first thing of focus to the list --- current-work/the-list.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/current-work/the-list.md b/current-work/the-list.md index 82a16563..961d2944 100644 --- a/current-work/the-list.md +++ b/current-work/the-list.md @@ -8,7 +8,7 @@ Please see the adjacent [README](./README.md). ### @relequestual -Link : -What? : -Why does it matter? : -What can people do? : +Link : https://github.com/json-schema-org/community/pull/250 +What? : Creating this file and the guide on how to use it +Why does it matter? : People feel it would be easier to see areas of focus if we highlight them +What can people do? : Review and approve this PR! =] From 817f45857c49ddc06caa4e81173774501e6b208d Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Thu, 13 Oct 2022 10:05:44 +0100 Subject: [PATCH 3/9] Fix formatting --- current-work/the-list.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/current-work/the-list.md b/current-work/the-list.md index 961d2944..8d01df6b 100644 --- a/current-work/the-list.md +++ b/current-work/the-list.md @@ -8,7 +8,7 @@ Please see the adjacent [README](./README.md). ### @relequestual -Link : https://github.com/json-schema-org/community/pull/250 -What? : Creating this file and the guide on how to use it -Why does it matter? : People feel it would be easier to see areas of focus if we highlight them -What can people do? : Review and approve this PR! =] +**Link:** https://github.com/json-schema-org/community/pull/250
+**What?:** Creating this file and the guide on how to use it
+**Why does it matter?:** People feel it would be easier to see areas of focus if we highlight them
+**What can people do?:** Review and approve this PR! =]
From 6de09e5bdc2e05b75ce03ac9caea2f63d89c598a Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Thu, 13 Oct 2022 10:08:13 +0100 Subject: [PATCH 4/9] Fix formatting for focus list template --- current-work/README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/current-work/README.md b/current-work/README.md index 82090f08..32bb68cb 100644 --- a/current-work/README.md +++ b/current-work/README.md @@ -27,10 +27,10 @@ If you're adding to the list for the first time, please copy the below template, Show/hide template ```md - Link: [Link to Github Issue, Pull Request, or Discussion] - What?: [The most simplest basic explanation of what the thing is about. Think a single tweets length or less.] - Why does it matter?: [Pitch why people should care about this too. Why do you care about it?] - What can we do?: [What would you like us to do in relation to this thing?] + **Link:** [Link to Github Issue, Pull Request, or Discussion]
+ **What?:** [The most simplest basic explanation of what the thing is about. Think a single tweets length or less.]
+ **Why does it matter?:** [Pitch why people should care about this too. Why do you care about it?]
+ **What can we do?:** [What would you like us to do in relation to this thing?]
``` @@ -41,4 +41,4 @@ OK! Great! You want [the-list.md](./the-list.md) ## More? -@relequestual had some ideas on how automation could make this easier to use and encourage engagement, but it lead to a rabbit hole of questions and looking at docs and there wasn't any low-hanging fruit to be had. He intends to write up some suggestions on this soon. \ No newline at end of file +@relequestual had some ideas on how automation could make this easier to use and encourage engagement, but it lead to a rabbit hole of questions and looking at docs and there wasn't any low-hanging fruit to be had. He intends to write up some suggestions on this soon. From f43212a00f5428564f1f9deb25dbde636934651e Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Thu, 13 Oct 2022 10:35:30 +0100 Subject: [PATCH 5/9] Fix show/hide template in readme for listing things --- current-work/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/current-work/README.md b/current-work/README.md index 32bb68cb..a3edfee8 100644 --- a/current-work/README.md +++ b/current-work/README.md @@ -23,7 +23,7 @@ If you'd like permission to commit to the repo, please do ask. If you're adding to the list for the first time, please copy the below template, and add your GitHub username in alphabetical order. - +
Show/hide template ```md @@ -33,7 +33,7 @@ If you're adding to the list for the first time, please copy the below template, **What can we do?:** [What would you like us to do in relation to this thing?]
``` - +
### Show me the details From 5a359e357072acac5f06ad9b89d64d13aa89fee9 Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Wed, 2 Nov 2022 14:23:23 +0000 Subject: [PATCH 6/9] Fix grammar --- current-work/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/current-work/README.md b/current-work/README.md index a3edfee8..1f5cd61a 100644 --- a/current-work/README.md +++ b/current-work/README.md @@ -17,7 +17,7 @@ We may introduce automations to assist in this at a later point, or a medium tha #### How should the file be updated? -Initially, only those who are actively contributing should look at add items to the list. +Initially, it's expected that only those who are actively contributing should look at add add items to the list. To add items to the list, either make commits directly, or make a PR and then nudge someone to approve it. If you'd like permission to commit to the repo, please do ask. From b931c1c8e952877831b55e68ffa13c5e5eac38bf Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Fri, 11 Nov 2022 15:25:02 +0000 Subject: [PATCH 7/9] Remove suggestion to use PRs for current-work list updating --- current-work/README.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/current-work/README.md b/current-work/README.md index 1f5cd61a..655f3654 100644 --- a/current-work/README.md +++ b/current-work/README.md @@ -18,8 +18,8 @@ We may introduce automations to assist in this at a later point, or a medium tha #### How should the file be updated? Initially, it's expected that only those who are actively contributing should look at add add items to the list. -To add items to the list, either make commits directly, or make a PR and then nudge someone to approve it. -If you'd like permission to commit to the repo, please do ask. +To add items to the list, either make commits directly in this repo. +If you'd like permission to commit to the repo, please do ask on our [Slack server](https://json-schema.org/slack) in the `#community` channel. If you're adding to the list for the first time, please copy the below template, and add your GitHub username in alphabetical order. @@ -42,3 +42,7 @@ OK! Great! You want [the-list.md](./the-list.md) ## More? @relequestual had some ideas on how automation could make this easier to use and encourage engagement, but it lead to a rabbit hole of questions and looking at docs and there wasn't any low-hanging fruit to be had. He intends to write up some suggestions on this soon. + +## I have a suggestion on this process... + +Great, let's hear it! Create a new [Discussion](https://github.com/json-schema-org/community/discussions) and let's talk. \ No newline at end of file From 588240d353b3bc69e295a412e2ad4150387d4ae1 Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Fri, 11 Nov 2022 15:26:08 +0000 Subject: [PATCH 8/9] Fix grammar --- current-work/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/current-work/README.md b/current-work/README.md index 655f3654..a11a84d7 100644 --- a/current-work/README.md +++ b/current-work/README.md @@ -17,7 +17,7 @@ We may introduce automations to assist in this at a later point, or a medium tha #### How should the file be updated? -Initially, it's expected that only those who are actively contributing should look at add add items to the list. +Initially, it's expected that only those who are actively contributing should look at or add items to the list. To add items to the list, either make commits directly in this repo. If you'd like permission to commit to the repo, please do ask on our [Slack server](https://json-schema.org/slack) in the `#community` channel. From 34bdd48d4687375ec10c284147e397d4a3ef9cdf Mon Sep 17 00:00:00 2001 From: Ben Hutton Date: Mon, 14 Nov 2022 13:34:08 +0000 Subject: [PATCH 9/9] Updated current work readme As per Henry's suggestions in reviewing PR #250 --- current-work/README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/current-work/README.md b/current-work/README.md index a11a84d7..99422026 100644 --- a/current-work/README.md +++ b/current-work/README.md @@ -3,11 +3,11 @@ ## About ### What is this space? -During an [Open Community Working Meeting](https://github.com/json-schema-org/community/issues/244), it was suggested that we could have a place for the core team (and maybe active community members?) to log their current areas of focus or interest in the form of GitHub Issues, Pull Requests, and Discussions. +During an [Open Community Working Meeting](https://github.com/json-schema-org/community/issues/244), it was suggested that we could have a place for the core team (and maybe active community members?) to indicate which areas of their work most require attention from the core team members, in the form of GitHub Issues, Pull Requests, and Discussions. ### Why? -We concluded there was a LOT of activity taking place, and it was hard to get people to focus on the "important things". It is indeed hard to focus on priority items when there are many new GitHub Issues and Discussions each week, especially for those who are community members or not working on JSON Schema full or even part time. It was suggested that by asking for one to three items of priority, we might find it easier to draw attention where we feel it is needed. +We concluded there was a LOT of activity taking place, and it was hard to get people to respond to the most immediately important things. It is indeed hard to focus on priority items when there are many new GitHub Issues and Discussions each week, especially for those who are community members or not working on JSON Schema full or even part time. It was suggested that by asking for one to three items of priority, we might find it easier to draw attention where we feel it is needed. ### How? @@ -18,7 +18,7 @@ We may introduce automations to assist in this at a later point, or a medium tha #### How should the file be updated? Initially, it's expected that only those who are actively contributing should look at or add items to the list. -To add items to the list, either make commits directly in this repo. +To add items to the list, make commits directly in this repo. If you'd like permission to commit to the repo, please do ask on our [Slack server](https://json-schema.org/slack) in the `#community` channel. If you're adding to the list for the first time, please copy the below template, and add your GitHub username in alphabetical order. @@ -45,4 +45,4 @@ OK! Great! You want [the-list.md](./the-list.md) ## I have a suggestion on this process... -Great, let's hear it! Create a new [Discussion](https://github.com/json-schema-org/community/discussions) and let's talk. \ No newline at end of file +Great, let's hear it! Create a new [Discussion](https://github.com/json-schema-org/community/discussions) and let's talk.