Skip to content

Commit c1fbd13

Browse files
committed
Initial proposal for JSON Schema blog guidelines
1 parent 4f6a8b7 commit c1fbd13

File tree

1 file changed

+54
-0
lines changed

1 file changed

+54
-0
lines changed

docs/blog-guidelines.md

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
# JSON Schema Blog Guidelines #
2+
3+
## JSN 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+
Note: This is not a link to a JSON Schema website or form on the JSON Schema website.
44+
45+
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.
46+
47+
## Promotion ##
48+
Please feel free to share the blog on social media.
49+
50+
## How to submit for consideration ##
51+
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.
52+
53+
### Atribution
54+
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)