Skip to content

Commit 220388a

Browse files
authored
Merge pull request #482 from json-schema-org/benjagm-blog-guidelines
Initial proposal for JSON Schema blog guidelines
2 parents e17cd7d + 71b10f5 commit 220388a

File tree

1 file changed

+55
-0
lines changed

1 file changed

+55
-0
lines changed

docs/blog-guidelines.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# JSON Schema Blog Guidelines #
2+
3+
## JSON Schema Blog Overview ##
4+
5+
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.
6+
7+
The content on our blog consists of:
8+
* Use cases and success stories
9+
* Technical content and how-to’s
10+
* Stories, updates and opinions about JSON Schema
11+
* Articles to present JSON Schema tooling
12+
* Industry insight into JSON Schema adoption
13+
* JSON Schema Community updates and reports
14+
15+
Other topics are welcome, but it needs to have a direct link to the JSON Schema Community.
16+
17+
We accept content from JSON Schema maintainers and contributors, implementation maintainers, and JSON Schema Champions.
18+
19+
Blog type definitions:
20+
* Tooling blog: Any blog post on a JSON Schema implementation.
21+
* Community blog: Any blog post about the Community written by a JSON Schema maintainer or contributor.
22+
* Ambassador blog: This is a blog written by one of the JSON Schema Ambassadors.
23+
* Opinion: This is a blog written by one of the JSON Schema maintainers or contributors to share a JSON Schema related opinion.
24+
* Update: This is a blog written by one of the JSON Schema maintainers to update about the project evolution.
25+
* Engineering: Any JSON Schema related technical post.
26+
27+
## Content ##
28+
The JSON Schema blog audience is developers, IT operators, and JSON Schema enthusiasts. Keep this in mind as you develop your blog content.
29+
30+
Some things to think about:
31+
* 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.
32+
* 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.
33+
* 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.
34+
* Critical commentary or broad issues must be approached with sensitivity, professionalism, and tact in a way that is beneficial and positive for the Community.
35+
* 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.
36+
37+
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:
38+
* Share contact info of speaker - twitter, slack, email
39+
* Links to company websites
40+
* Links to projects websites or Github
41+
* Can advertise if they are hiring and who to contact if interested
42+
43+
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.
44+
45+
## Promotion ##
46+
Please feel free to share the blog on social media.
47+
48+
## How to submit for consideration ##
49+
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.
50+
51+
### Note on JSON Champions
52+
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.
53+
54+
### Atribution
55+
These blog guidelines are adapted by the [CNCF blog guidelines](https://github.com/cncf/foundation/blob/main/blog-guidelines.md).

0 commit comments

Comments
 (0)