Rename core notions

[leplatrem]

Now that cliquet is in kinto.core, some naming is confusing.

In the core, resources are called collections, and objects are called records.

But, in Kinto, collections and records are instantiation of resources!

I suggest some renaming in kinto.core:

• collection to resource
• record to object
• collection_id to resource_name (or object_type ?)
• record_id to object_id

That represents quite some work, but reducing confusion is always worth it.

[leplatrem]

• impacted_records → impacted_objects

[leplatrem]

• Total-Records -> Total-Objects

[almet]

This would allow a lot more readability, that's a good idea.

[mansimarkaur]

I'd love to work on this.

[mansimarkaur]

object is a global variable in Python. Should we be concerned about that when we move from record -> object?

[Natim]

Should we be concerned about that when we move from record -> object?

Yes

[mansimarkaur]

So, what else should we name a record as if not object?

[Natim]

Cannot we be concerned and still use it?

[Natim]

To elaborate I think that most of the time we will use object_id and if we need to use object we can choose to use obj instead to not override the object Python global variable?

[mansimarkaur]

Yes, obj seems to be a good option. Thanks!

[leplatrem]

• Collection endpoint → Plural endpoint
• Record endpoint → Object endpoint

[leplatrem]

with_deleted=False → leave_tombstones=False
include_deleted=False → with_tombstones=False

[leplatrem]

process_record() → process_object()

[glasserc]

collection_timestamp -> ?? I don't like resource_timestamp. Maybe plural_timestamp, or children_timestamp?

[peterbe]

What about https://kinto.readthedocs.io/en/stable/api/1.x/records.html
We renamed the Total-Records header to Total-Objects (but kept both to be gentle). Should the /records (and its documentation) be redirects for /objects now?

[leplatrem]

Nope, because in this case records is not a «core notion». Now core has the notion of objects, and buckets, collections, groups, records and accounts leverage it.

Before it was confusing because there were the terms records and collections in kinto.core...