Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

The JSON Schema Charter #325

Open
wants to merge 83 commits into
base: main
Choose a base branch
from
Open

The JSON Schema Charter #325

Changes from 1 commit
Commits
Show all changes
83 commits
Select commit Hold shift + click to select a range
0b8d59b
Initial commit of charter template Copy from OpenJS Foundation CPC repo
Relequestual Feb 7, 2023
4666a22
Add comments to heading for people who might edit the file, and a lin…
Relequestual Feb 7, 2023
3cc72d2
Add content for Guiding Principles
Relequestual Feb 7, 2023
b7de5e1
Add content for Scope section
Relequestual Feb 7, 2023
a4bf147
Modified version of Scope
Relequestual Feb 7, 2023
327b09e
Add sections 1.1 and 1.2 re scope In-scope does not yet have any sugg…
Relequestual Feb 7, 2023
cdc7cf5
Add Relationship with OpenJS Foundation CPC section
Relequestual Feb 7, 2023
d60d388
Add Other Formal Project Relationships section Left blank
Relequestual Feb 7, 2023
ece5e53
Add Governing Body (TSC) section
Relequestual Feb 7, 2023
2d38695
Add Roles and Responsibilities section
Relequestual Feb 9, 2023
29ed1a5
Add Project Operations and Management section
Relequestual Feb 9, 2023
c9a6006
Add Decision-making and Voting section
Relequestual Feb 10, 2023
d0d58ba
Add Definitions section
Relequestual Feb 10, 2023
0c0f97c
Add footer with links to resources
Relequestual Feb 10, 2023
557c0a2
Fix typos
Relequestual Feb 20, 2023
5abe1bd
Add note about how testing for agreement is not the same as voting.
Relequestual Feb 21, 2023
9ba125a
Refine consensus model
Relequestual Feb 23, 2023
9301be9
Tidy up and break out section for ADRs
Relequestual Feb 23, 2023
e3ecb1e
Add definition of TSC
Relequestual Mar 3, 2023
f6ac84c
Recognize other project roles to be defined
Relequestual Mar 3, 2023
a2af3ba
Add detail about signal based voting at the Test for Agreement stage …
Relequestual Mar 8, 2023
3fc951e
Spacing
Relequestual Mar 8, 2023
df8930a
Amend decision making process in charter
Relequestual Mar 14, 2023
cfa2ae9
Fix inconsistent name for repos
Relequestual Mar 14, 2023
a6bc2a8
Add details for project scope in the charter
Relequestual Mar 14, 2023
d30322d
Add line about non-technical conflicts to the charter
Relequestual Mar 16, 2023
fea1163
Update CHARTER.md
Relequestual Mar 20, 2023
14d7ca2
Fix using upper case inside bracket
Relequestual Mar 24, 2023
90896a9
Remove specific mention of linting tooling.
Relequestual Mar 28, 2023
dc3785a
Add time limits to some stages of consensus process
Relequestual Mar 30, 2023
c35d423
Provide blocker fallback
Relequestual Apr 6, 2023
c1f0fa4
Add details to ADR for consensus based TSC
Relequestual Apr 11, 2023
42e1c54
Remove comments not intended for final document
Relequestual Apr 13, 2023
1b31445
Fix typo
Relequestual Apr 13, 2023
9634a60
Remove additional comment and mention governance document is to be cr…
Relequestual Apr 13, 2023
8f1df0f
Remove (optional) from headings in charter
Relequestual Apr 13, 2023
f5dd0f5
Add initial TSC members list
Relequestual Apr 13, 2023
d083f46
Fix grammar
Relequestual Apr 13, 2023
6653e46
Fix typo in charter
Relequestual Apr 13, 2023
c84610a
Apply grammar and typo fixes to charter from PR review
Relequestual Apr 13, 2023
a4943cd
Remove specific TSC member requirement about meetings
Relequestual Apr 17, 2023
94d1801
Fix double typo with thanks to @mwadams
Relequestual Apr 17, 2023
c9ab2dd
List names and links for the TSC members
Relequestual Apr 18, 2023
b5f0e85
Fix typo and quotes in charter
Relequestual Apr 18, 2023
b2efdce
Fix typos and quotes in charter
Relequestual Apr 18, 2023
d2f853c
Fix grammar in charter
Relequestual Apr 18, 2023
035ab9b
Remove 'section' from titles
Relequestual Apr 18, 2023
dc3e685
Fix language specific spellings in charter
Relequestual Apr 18, 2023
631db8c
Specifically mention specifications we use and that use us as out of …
Relequestual Apr 18, 2023
8eb9883
Do not reference 'JSON Schema Org'
Relequestual Apr 24, 2023
341ecef
Do not define what the OpenJS Foundation does, per feedback from the …
Relequestual Apr 25, 2023
f4e35ff
Remove mention of fund and budgeting, as the charter is about the fou…
Relequestual Apr 25, 2023
e94c0cb
Remove mention of finances as per last commit
Relequestual Apr 25, 2023
9e1ad26
Remove mention of special interest groups in favour of noting the com…
Relequestual Apr 25, 2023
52bedb3
Loosen TSC meeting expectations
Relequestual Apr 26, 2023
4a2ad4a
Intro section better reflects the JSON Schema projects relationship w…
Relequestual Apr 25, 2023
397a8d1
Don't use 'we' and use proper pronouns
Relequestual May 3, 2023
d79198e
Move the list of initial TSC members outside of the charter document
Relequestual May 3, 2023
59deddb
Use 'private' as opposed to 'non-public'
Relequestual May 3, 2023
f1974e2
Remove the explicit mention of ingesting tooling into the project
Relequestual Jun 15, 2023
c872a5f
Note what kinds of discussions and votes can and should be made private
Relequestual Jun 16, 2023
a974117
Move the paragraph about TSC period of leave to membership section
Relequestual Jun 16, 2023
86ff12e
Create governance document and move governance and process related co…
Relequestual Jun 23, 2023
55aa9b3
Refined definition of TSC in context
Relequestual Jun 23, 2023
75542a8
Move content about voting and additional project roles from charter t…
Relequestual Jun 26, 2023
aea0b80
Add interoperability to list of in scope concerns
Relequestual Jun 26, 2023
fbe8b54
Change 'JSON data' to 'JSON-compatible data' in charter
Relequestual Jun 27, 2023
63cf673
Use more inclusive phrasing
Relequestual Jul 10, 2023
a996e13
Remove content which is mostly a duplication of section 2
Relequestual Jul 10, 2023
2a92249
Simplify out of scope sction. Add engaging with upstream and downstre…
Relequestual Jul 11, 2023
58d942b
Move TSC policy elements to charter from governance document
Relequestual Jul 13, 2023
8b2ed66
Add that TSC meetings should have an agenda
Relequestual Jul 13, 2023
be38006
Move roles and responsibilities section back to charter document with…
Relequestual Jul 25, 2023
4c92fc6
Migrate some content regarding process out of the governance document…
Relequestual Jul 25, 2023
507246b
Remove governance document for the Charter PR
Relequestual Jul 25, 2023
26f9265
Improve phrasing for out of scope
Relequestual Aug 2, 2023
31d5f6e
Tighten phrasing
Relequestual Aug 2, 2023
47a0d79
Note that updates to the charter must be approved by the OpenJS Found…
Relequestual Aug 2, 2023
37eccb2
Include the CPC
Relequestual Aug 2, 2023
bea5924
Strive to be open, always!
Relequestual Aug 2, 2023
91d5133
Remove initial included license and add CC-BY 4.0
Relequestual Aug 3, 2023
cdce30b
Fix posession
Relequestual Aug 3, 2023
06240f9
Fix grammar
Relequestual Aug 9, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CHARTER.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Secondary Concerns
- Vocabularies registry

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd also add "Format registry" - since OpenAPI has one, and it really should be part of the JSON Schema project for more compatibility.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What value have you seen come from the OpenAPI format registry?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It provides a reference for applications so they can provide a consistent implementation of formats -- which is why we have specifications.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It should be noted (and I imagine Karen is aware from the OpenAPI side of things) that were looking at importing the format registry from OpenAPI.

### 1.2: Out-of-Scope
Standards that the JSON Schema project uses (such as JSON and IRI), nor standards and projects that use JSON Schema (such as OpenAPI and AsyncAPI), are not things which the JSON Schema project has any control over.
Neither standards that the JSON Schema project uses (such as JSON and IRI) nor standards or projects that use JSON Schema (such as OpenAPI or AsyncAPI) are in scope, nor does the JSON Schema project has any control over them.
Relequestual marked this conversation as resolved.
Show resolved Hide resolved

## 2: Relationship with OpenJS Foundation CPC.
Most large, complex open source communities have both a business and a technical governance model. Technical leadership for the projects within the OpenJS Foundation is delegated to the projects through their project charters by the OpenJS Cross Project Council (CPC). In the case of the JSON Schema project, it is delegated to the JSON Schema Technical Steering Committee ("TSC").
Expand Down