Skip to content

Commit 9d2472e

Browse files
fix(AIP-132): mention Lists across multiple collections (#1044)
As a follow-up to #1043, fixing wording that implies that only a single finite collection is allowed to allow more than one in the case of AIP-159. Co-authored-by: Noah Dietz <noahdietz@users.noreply.github.com>
1 parent 0371fe4 commit 9d2472e

1 file changed

Lines changed: 5 additions & 2 deletions

File tree

aip/general/0132.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,9 @@ parameters), and return a list of responses matching that input.
2121
## Guidance
2222

2323
APIs **must** provide a `List` method for resources unless the resource is a
24-
[singleton][]. The purpose of the `List` method is to return data from a single,
25-
finite collection.
24+
[singleton][]. The purpose of the `List` method is to return data from a finite
25+
collection (generally singular unless the operation supports [reading across
26+
collections][]).
2627

2728
List methods are specified using the following pattern:
2829

@@ -198,11 +199,13 @@ NOT_FOUND errors][permission-denied].
198199
[aip-203]: ./0203.md
199200
[errors]: ./0193.md
200201
[permission-denied]: ./0193.md#permission-denied
202+
[reading across collections]: ./0159.md
201203
[singleton]: ./0156.md
202204
[soft delete]: ./0135.md#soft-delete
203205

204206
## Changelog
205207

208+
- **2023-03-22**: Fix guidance wording to mention AIP-159.
206209
- **2023-03-17**: Align with AIP-122 and make Get a must.
207210
- **2022-11-04**: Aggregated error guidance to AIP-193.
208211
- **2022-06-02**: Changed suffix descriptions to eliminate superfluous "-".

0 commit comments

Comments
 (0)