Skip to content

Commit ad63a33

Browse files
authored
Set inital readme
Add some basic details about this repo and how we should use it.
1 parent a3c5a8d commit ad63a33

File tree

1 file changed

+43
-2
lines changed

1 file changed

+43
-2
lines changed

README.md

+43-2
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,43 @@
1-
# community
2-
A space to discuss community and organisational related things
1+
# JSON Schema Community
2+
3+
🚨This is a work in progress (2021/04 - @relequestual)🚨
4+
5+
# What is this repo?
6+
7+
This repo is a place to discuss and debate various aspects of running the JSON Schema organisation, how we work as a community, and our expectations.
8+
9+
The discussions will primerily take place using [Github Discussions](https://github.com/json-schema-org/community/discussions) for this repo.
10+
11+
Initially Github issues will be disabled as we evaluate how we should use them in this repo (through Discussions).
12+
13+
Once we have some links for the community, this readme will link to various locations, resources, and documents that are useful for the community.
14+
15+
# Who can use this repo?
16+
17+
Anyone who wants to learn about, be part of, or help improve the JSON Schema community is welcome here.
18+
19+
Anyone can start a discussion in any category. You can even start a discussion to suggest adding a new category!
20+
21+
# Why do we need this repo to have discussions?
22+
23+
Slack is really great for chatting, working through tricky problems, having one-to-one support sessions.
24+
25+
Slack is not so great for long running ideas, plans, or discussions, a point of reference for decisions, keeping a log of progress.
26+
27+
Using Github Discussions, we can collaborate on important decisons over a longer period of time and have a long standing point of reference
28+
29+
# Why not just use Github Issues?
30+
31+
Github Issues are great for getting work done, but not so great at having threaded debates and discussions.
32+
33+
Picking to use Github Discussions before creating an issue allows us to seek consensus in discussion and keep Issues as the space for tracking work product and its progress.
34+
35+
# Who decided all this? Is it up for debate?
36+
37+
Ben Hutton (@relequestual) created this repo and inital readme on April 2021, based on the expectations of community and organisational needs having grown, supported, and observed the community over the past 5 years.
38+
39+
**None of this is set in stone. Humans are fallible. Everything is up for debate.**
40+
41+
While Ben has become the self-appointed core team lead at some point during those 5 years, we strive to work on a model of general consensus, which works well for specification development, and is something we rely on to move us forward.
42+
43+
Ben acts in several ways as an executive for the organisation, and feels trusted enough to make organisational decisions like this with the expectation of change and with as much transparancy as possible.

0 commit comments

Comments
 (0)