REST guide terminology: document vs. entity and filter vs. search

[pvdbosch]

In GitLab by @pvdbosch on Nov 20, 2019, 15:01

During presentation of the REST guide to Flanders, there was some feedback on naming:

• resource archetype "Document": would "Entity" be a better name?
  • an entity implies something with an identity, while "document" is like a volatile message
• "Filtering" on collections: would "searching" be better?
  • the goal is finding items within collections
  • filtering could be misunderstood as property-level filtering on a response (?select=...)

[pvdbosch]

In GitLab by @pvdbosch on Nov 20, 2019, 15:01

changed the description