8000 Add milestones to home page, move full history to /about · roy-coder/json-api@3eccc4f · GitHub
[go: up one dir, main page]

Skip to content

Commit 3eccc4f

Browse files
committed
Add milestones to home page, move full history to /about
1 parent 81c3dd9 commit 3eccc4f

File tree

2 files changed

+48
-44
lines changed

2 files changed

+48
-44
lines changed

about/index.md

Lines changed: 41 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,6 @@ The following emeritus editors are no longer active:
2727
- [Steve Klabnik](https://twitter.com/steveklabnik)
2828
- [Ethan Resnick](https://twitter.com/ethanresnick)
2929

30-
## <a href="#roadmap" id="roadmap" class="headerlink"></a> Roadmap
31-
32-
### <a href="#roadmap-1-1" id="roadmap-1-1" class="headerlink"></a> 1.1
33-
34-
* Embedding / creating multiple related resources in a single request
35-
* Extension support
36-
3730
## <a href="#history" id="history" class="headerlink"></a> History
3831

3932
JSON:API was originally drafted by [Yehuda Katz](https://twitter.com/wycats)
@@ -72,3 +65,44 @@ The goals of the media type are to balance:
7265
* Ease of implementation on the client side
7366

7467
This specification reached a stable version 1.0 on May 29, 2015.
68+
69+
### <a href="#update-history" id="update-history" class="headerlink"></a> Update history
70+
71+
- 2022-09-30: 1.1 final released.
72+
- 2022-08-22: 1.1 Release candidate 4 released.
73+
- Formalized the definition of specification and implementation
74+
[semantics](https://jsonapi.org/format/1.1/#semantics).
75+
- Refined the definitions of
76+
[extensions](https://jsonapi.org/format/1.1/#extensions) and
77+
[profiles](https://jsonapi.org/format/1.1/#profiles).
78+
- Clarified details regarding expected and allowed responses, query
79+
parameters, and more.
80+
- 2020-10-01: 1.1 Release candidate 3 released.
81+
- Refined links objects. The link object `params` member was removed to
82+
better align with other JSON link serializations. The `anchor` target
83+
attribute was also removed. It may be restored in a future minor release.
84+
- 2020-08-20: 1.1 Release candidate 2 released.
85+
- [Extensions](https://jsonapi.org/format/1.1/#extensions) were added and the
86+
scope of [profiles](https://jsonapi.org/format/1.1/#profiles) were reduced
87+
since their introduction in RC1.
88+
- [Links](https://github.com/json-api/json-api/pull/1348) can be represented
89+
as [RFC 8288](https://tools.ietf.org/html/rfc8288)-style web links.
90+
- A new [`describedby`](https://github.com/json-api/json-api/pull/1447) [links member](https://jsonapi.org/format/1.1/#document-top-level)
91+
was added so that implementors can incorporate description documents (e.g.
92+
[OpenAPI](https://www.openapis.org/) or [JSON Schema](https://json-schema.org/specification.html))
93+
directly into their APIs.
94+
- [Local IDs](https://jsonapi.org/format/1.1/#document-resource-object-identification)
95+
were [introduced](https://github.com/json-api/json-api/pull/1244) so that a
96+
client can create a relationship to a resource yet-to-be created by the
97+
same request.
98+
- 2018-12-01: 1.1 Release candidate 1 released.
99+
- New features include: [profiles](https://jsonapi.org/format/1.1/#profiles), ["@-Members"](https://jsonapi.org/format/1.1/#document-member-names-at-members), and [error object `type` links](https://jsonapi.org/format/1.1/#error-objects).
100+
- There are editorial clarifications around: [query parameters](https://jsonapi.org/format/1.1/#query-parameters) (their parsing/serialization, and reserved parameter names), the appropriate status code for [specific](https://github.com/json-api/json-api/pull/1036) [responses](https://github.com/json-api/json-api/pull/1029), and the [presence of the `included` key](https://github.com/json-api/json-api/pull/1236) even when its value is an empty array.
101+
- JSON:API switched to [recommending camelCased names](https://jsonapi.org/recommendations/#naming).
102+
- 2015-05-29: 1.0 final released.
103+
- 2015-05-21: 1.0 Release candidate 4 released.
104+
- 2015-03-16: 1.0 Release candidate 3 released.
105+
- 2015-02-18: 1.0 Release candidate 2 released.
106+
- 2014-07-05: 1.0 Release candidate 1 released.
107+
- 2013-07-21: Media type registration completed with the IANA.
108+
- 2013-05-03: Initial release of the draft.

index.md

Lines changed: 7 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -123,45 +123,15 @@ base JSON:API specification. These extensions are called profiles.
123123
You can [browse existing profiles](/extensions/#existing-profiles) or
124124
[create a new one](/extensions/#profile-creation).
125125

126-
## <a href="#update-history" id="update-history" class="headerlink"></a> Update history
127-
128-
- 2022-09-30: Expected final release of 1.1.
129-
- 2022-08-22: 1.1 Release candidate 4 released.
130-
- Formalized the definition of specification and implementation
131-
[semantics](https://jsonapi.org/format/1.1/#semantics).
132-
- Refined the definitions of
133-
[extensions](https://jsonapi.org/format/1.1/#extensions) and
134-
[profiles](https://jsonapi.org/format/1.1/#profiles).
135-
- Clarified details regarding expected and allowed responses, query
136-
parameters, and more.
137-
- 2020-10-01: 1.1 Release candidate 3 released.
138-
- Refined links objects. The link object `params` member was removed to
139-
better align with other JSON link serializations. The `anchor` target
140-
attribute was also removed. It may be restored in a future minor release.
141-
- 2020-08-20: 1.1 Release candidate 2 released.
142-
- [Extensions](https://jsonapi.org/format/1.1/#extensions) were added and the
143-
scope of [profiles](https://jsonapi.org/format/1.1/#profiles) were reduced
144-
since their introduction in RC1.
145-
- [Links](https://github.com/json-api/json-api/pull/1348) can be represented
146-
as [RFC 8288](https://tools.ietf.org/html/rfc8288)-style web links.
147-
- A new [`describedby`](https://github.com/json-api/json-api/pull/1447) [links member](https://jsonapi.org/format/1.1/#document-top-level)
148-
was added so that implementors can incorporate description documents (e.g.
149-
[OpenAPI](https://www.openapis.org/) or [JSON Schema](https://json-schema.org/specification.html))
150-
directly into their APIs.
151-
- [Local IDs](https://jsonapi.org/format/1.1/#document-resource-object-identification)
152-
were [introduced](https://github.com/json-api/json-api/pull/1244) so that a
153-
client can create a relationship to a resource yet-to-be created by the
154-
same request.
155-
- 2018-12-01: 1.1 Release candidate 1 released.
156-
- New features include: [profiles](https://jsonapi.org/format/1.1/#profiles), ["@-Members"](https://jsonapi.org/format/1.1/#document-member-names-at-members), and [error object `type` links](https://jsonapi.org/format/1.1/#error-objects).
157-
- There are editorial clarifications around: [query parameters](https://jsonapi.org/format/1.1/#query-parameters) (their parsing/serialization, and reserved parameter names), the appropriate status code for [specific](https://github.com/json-api/json-api/pull/1036) [responses](https://github.com/json-api/json-api/pull/1029), and the [presence of the `included` key](https://github.com/json-api/json-api/pull/1236) even when its value is an empty array.
158-
- JSON:API switched to [recommending camelCased names](https://jsonapi.org/recommendations/#naming).
126+
## <a href="#milestones" id="milestones" class="headerlink"></a> Milestones
127+
128+
Major milestones for this specification include:
129+
130+
- 2022-09-30: 1.1 final released.
159131
- 2015-05-29: 1.0 final released.
160-
- 2015-05-21: 1.0 Release candidate 4 released.
161-
- 2015-03-16: 1.0 Release candidate 3 released.
162-
- 2015-02-18: 1.0 Release candidate 2 released.
163-
- 2014-07-05: 1.0 Release candidate 1 released.
164132
- 2013-07-21: Media type registration completed with the IANA.
165133
- 2013-05-03: Initial release of the draft.
166134

135+
A more thorough history is available [here](/about/#update-history).
136+
167137
You can subscribe to an RSS feed of individual changes [here](https://github.com/json-api/json-api/commits.atom).

0 commit comments

Comments
 (0)
0