Merge pull request #147 from dgeb/fieldset-tweaks

wycats · wycats · commit 2c94d1a97ea5 · 2013-11-07T09:42:09.000-08:00
Clarify when default fieldsets should be returned.
diff --git a/format/index.md b/format/index.md
@@ -568,6 +568,10 @@ with a `fields[DOCUMENT_TYPE]` parameter.
 GET /posts?include=authors&fields[posts]=id,title&fields[people]=id,name
 ```
 
+An endpoint SHOULD return a default set of fields for a document if no fields
+have been specified for its type, or if the endpoint does not support use of
+either `fields` or `fields[DOCUMENT_TYPE]`.
+
 Note: `fields` and `fields[DOCUMENT_TYPE]` can not be mixed. If the latter
 format is used, then it must be used for the primary document type as well.
 
