From c1fbd13088ededb363c538c6834d72827741808d Mon Sep 17 00:00:00 2001 From: Benjamin Granados Date: Wed, 13 Sep 2023 14:52:35 +0200 Subject: [PATCH 1/9] Initial proposal for JSON Schema blog guidelines --- docs/blog-guidelines.md | 54 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 docs/blog-guidelines.md diff --git a/docs/blog-guidelines.md b/docs/blog-guidelines.md new file mode 100644 index 00000000..83fe518e --- /dev/null +++ b/docs/blog-guidelines.md @@ -0,0 +1,54 @@ +# JSON Schema Blog Guidelines # + +## JSN Schema Blog Overview ## + +The JSON Schema blog serves as a channel for project maintainers and contributors, implementation maintainers and JSON Schema Champions to share content with the JSON Schema Community. + +The content on our blog consists of: +* Use cases and success stories +* Technical content and how-to’s +* Stories, updates and opinions about JSON Schema +* Articles to present JSON Schema tooling +* Industry insight into JSON Schema adoption +* JSON Schema Community updates and reports + +Other topics are welcome, but it needs to have a direct link to the JSON Schema Community. + +We accept content from JSON Schema maintainers and contributors, implementation maintainers and JSON Schema Champions. + +Blog type definitions: +* Tooling blog: Any blog post on a JSON Schema implementation. +* Community blog: Any blog post about the Community written by a JSON Schema maintainer or contributor. +* Ambassador blog: This is a blog written by one of the JSON Schema Ambassadors. +* Opinion: This is a blog written by one of the JSON Schema maintainers or contributors to share a JSON Schema related opinion. +* Update: This is a blog written by one of the JSON Schema maintainers to update about the project evolution. +* Engineering: Any JSON Schema related technical post. + +## Content ## +The JSON Schema blog audience is developers, IT operators, and JSON Schema enthusiasts. Keep this in mind as you develop your blog content. + +Some things to think about: +* Posts from members must be vendor-neutral. The post may mention a vendor’s name as it relates to specific open source projects, project deployments, adoption paths, their hosting of an in-person event or speaking at an event, or other indications of meaningful participation in the Community, but it shouldn’t feel like an advertisement for your services or company. We do not accept announcements or press releases to the JSON Schema blog. +* The most interesting posts are how-to blogs, blogs with technical content, and those that teach or show how to do something in a way others may not have thought of. +* Blog posts that show hurdles that were encountered and explain how they were overcome often do very well as the Community is looking to learn. +* Critical commentary or broad issues must be approached with sensitivity, professionalism, and tact in a way that is beneficial and positive for the Community. +* Your post must be your content, but can be published elsewhere with a right to republish. All content should have an author and be published Creative Commons with Attribution. + +Members can add 1-2 sentences at the end of their blog with a link to an external site such as their website or a gated asset. Examples for best practices: +* Share contact info of speaker - twitter, slack, email +* Links to company websites +* Links to projects websites or Github +* Can advertise if they are hiring and who to contact if interested + +Note: This is not a link to a JSON Schema website or form on the JSON Schema website. + +JSON Schema will review the statement, as we do for the content for the blog, to approve the content. If changes are needed, we will provide suggested changes. + +## Promotion ## +Please feel free to share the blog on social media. + +## How to submit for consideration ## +Please submit your PR for consideration and we will start the PR process. If the article it’s not suitable for the JSON Schema blog, we will provide feedback and direction. + +### Atribution +These blog guidelines are adapted by the [CNCF blog guidelines](https://github.com/cncf/foundation/blob/main/blog-guidelines.md). \ No newline at end of file From be5a4c184efc826b0891ccbbc17073ac8f4ebea8 Mon Sep 17 00:00:00 2001 From: Benjamin Granados <40007659+benjagm@users.noreply.github.com> Date: Thu, 14 Sep 2023 10:11:43 +0200 Subject: [PATCH 2/9] Update docs/blog-guidelines.md Co-authored-by: Jason Desrosiers --- docs/blog-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/blog-guidelines.md b/docs/blog-guidelines.md index 83fe518e..7d83680a 100644 --- a/docs/blog-guidelines.md +++ b/docs/blog-guidelines.md @@ -48,7 +48,7 @@ JSON Schema will review the statement, as we do for the content for the blog, to Please feel free to share the blog on social media. ## How to submit for consideration ## -Please submit your PR for consideration and we will start the PR process. If the article it’s not suitable for the JSON Schema blog, we will provide feedback and direction. +Please submit your PR for consideration and we will start the PR process. If the article is not suitable for the JSON Schema blog, we will provide feedback and direction. ### Atribution These blog guidelines are adapted by the [CNCF blog guidelines](https://github.com/cncf/foundation/blob/main/blog-guidelines.md). \ No newline at end of file From d0f587dbb77fd365d5da9ff9e66fa91563f44bae Mon Sep 17 00:00:00 2001 From: Benjamin Granados <40007659+benjagm@users.noreply.github.com> Date: Fri, 15 Sep 2023 11:21:41 +0200 Subject: [PATCH 3/9] Update docs/blog-guidelines.md Co-authored-by: Ben Hutton --- docs/blog-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/blog-guidelines.md b/docs/blog-guidelines.md index 7d83680a..23989c5c 100644 --- a/docs/blog-guidelines.md +++ b/docs/blog-guidelines.md @@ -1,6 +1,6 @@ # JSON Schema Blog Guidelines # -## JSN Schema Blog Overview ## +## JSON Schema Blog Overview ## The JSON Schema blog serves as a channel for project maintainers and contributors, implementation maintainers and JSON Schema Champions to share content with the JSON Schema Community. From bd99e77c65d02ddea75b1861308ae9cca0625b10 Mon Sep 17 00:00:00 2001 From: Benjamin Granados <40007659+benjagm@users.noreply.github.com> Date: Fri, 15 Sep 2023 11:23:04 +0200 Subject: [PATCH 4/9] Update docs/blog-guidelines.md Co-authored-by: Ben Hutton --- docs/blog-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/blog-guidelines.md b/docs/blog-guidelines.md index 23989c5c..69518be1 100644 --- a/docs/blog-guidelines.md +++ b/docs/blog-guidelines.md @@ -2,7 +2,7 @@ ## JSON Schema Blog Overview ## -The JSON Schema blog serves as a channel for project maintainers and contributors, implementation maintainers and JSON Schema Champions to share content with the JSON Schema Community. +The JSON Schema blog serves as a channel for project maintainers and contributors, implementation maintainers, and JSON Schema Champions to share content with the JSON Schema Community. The content on our blog consists of: * Use cases and success stories From c0786e6bbcb24836e83bf8a6c56ee9d46519cb38 Mon Sep 17 00:00:00 2001 From: Benjamin Granados <40007659+benjagm@users.noreply.github.com> Date: Fri, 15 Sep 2023 11:23:16 +0200 Subject: [PATCH 5/9] Update docs/blog-guidelines.md Co-authored-by: Ben Hutton --- docs/blog-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/blog-guidelines.md b/docs/blog-guidelines.md index 69518be1..b6ad90b7 100644 --- a/docs/blog-guidelines.md +++ b/docs/blog-guidelines.md @@ -14,7 +14,7 @@ The content on our blog consists of: Other topics are welcome, but it needs to have a direct link to the JSON Schema Community. -We accept content from JSON Schema maintainers and contributors, implementation maintainers and JSON Schema Champions. +We accept content from JSON Schema maintainers and contributors, implementation maintainers, and JSON Schema Champions. Blog type definitions: * Tooling blog: Any blog post on a JSON Schema implementation. From ccd69914f9576f027389a9e9150a5c7d76071624 Mon Sep 17 00:00:00 2001 From: Benjamin Granados <40007659+benjagm@users.noreply.github.com> Date: Fri, 15 Sep 2023 11:23:26 +0200 Subject: [PATCH 6/9] Update docs/blog-guidelines.md Co-authored-by: Ben Hutton --- docs/blog-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/blog-guidelines.md b/docs/blog-guidelines.md index b6ad90b7..27e3ffa7 100644 --- a/docs/blog-guidelines.md +++ b/docs/blog-guidelines.md @@ -35,7 +35,7 @@ Some things to think about: * Your post must be your content, but can be published elsewhere with a right to republish. All content should have an author and be published Creative Commons with Attribution. Members can add 1-2 sentences at the end of their blog with a link to an external site such as their website or a gated asset. Examples for best practices: -* Share contact info of speaker - twitter, slack, email +* Share contact info of speaker - twitter, slack, email * Links to company websites * Links to projects websites or Github * Can advertise if they are hiring and who to contact if interested From e70f1a214b9a8d2907e74c26f7037b53bd5ad7c3 Mon Sep 17 00:00:00 2001 From: Benjamin Granados <40007659+benjagm@users.noreply.github.com> Date: Fri, 15 Sep 2023 11:26:54 +0200 Subject: [PATCH 7/9] Update docs/blog-guidelines.md Co-authored-by: Ben Hutton --- docs/blog-guidelines.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/blog-guidelines.md b/docs/blog-guidelines.md index 27e3ffa7..3195799f 100644 --- a/docs/blog-guidelines.md +++ b/docs/blog-guidelines.md @@ -42,7 +42,7 @@ Members can add 1-2 sentences at the end of their blog with a link to an externa Note: This is not a link to a JSON Schema website or form on the JSON Schema website. -JSON Schema will review the statement, as we do for the content for the blog, to approve the content. If changes are needed, we will provide suggested changes. +The JSON Schema project will review the statement, as we do for the content for the blog, to approve the content. If changes are needed, we will provide feedback or suggested changes. ## Promotion ## Please feel free to share the blog on social media. From ba27a2e61622a8b28ca9da7c83a99dda4493d59b Mon Sep 17 00:00:00 2001 From: Benjamin Granados Date: Fri, 15 Sep 2023 11:33:10 +0200 Subject: [PATCH 8/9] Remove unnecessary note. --- docs/blog-guidelines.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/blog-guidelines.md b/docs/blog-guidelines.md index 3195799f..92dc24d0 100644 --- a/docs/blog-guidelines.md +++ b/docs/blog-guidelines.md @@ -40,8 +40,6 @@ Members can add 1-2 sentences at the end of their blog with a link to an externa * Links to projects websites or Github * Can advertise if they are hiring and who to contact if interested -Note: This is not a link to a JSON Schema website or form on the JSON Schema website. - The JSON Schema project will review the statement, as we do for the content for the blog, to approve the content. If changes are needed, we will provide feedback or suggested changes. ## Promotion ## From 71b10f5fd199e31c60475d3940e2733399a8d777 Mon Sep 17 00:00:00 2001 From: Benjamin Granados <40007659+benjagm@users.noreply.github.com> Date: Mon, 18 Sep 2023 11:40:53 +0200 Subject: [PATCH 9/9] Update blog-guidelines.md to add a definition of JSON Schema Champion. I realized that we don't have a definition of JSON Schema Champion what introduces some ambiguity here, this is way I am adding a definition. --- docs/blog-guidelines.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/blog-guidelines.md b/docs/blog-guidelines.md index 92dc24d0..7e2265dd 100644 --- a/docs/blog-guidelines.md +++ b/docs/blog-guidelines.md @@ -48,5 +48,8 @@ Please feel free to share the blog on social media. ## How to submit for consideration ## Please submit your PR for consideration and we will start the PR process. If the article is not suitable for the JSON Schema blog, we will provide feedback and direction. +### Note on JSON Champions +Until we publish an official definition of JSON Schema Champion, we consider JSON Schema Champions to experts, educators, authors, and event organizers relevant to the JSON Schema ecosystem. + ### Atribution -These blog guidelines are adapted by the [CNCF blog guidelines](https://github.com/cncf/foundation/blob/main/blog-guidelines.md). \ No newline at end of file +These blog guidelines are adapted by the [CNCF blog guidelines](https://github.com/cncf/foundation/blob/main/blog-guidelines.md).