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)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy