You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
ContentSource is a reference to a specific instance of content at a slug (e.g. version/state/however you are choosing to model it); it basically consists of {Slug,ID}.
Content is the common envelope for all content; it has timestamps, author info, title, etc.
ContentPayload is the actual "content" in the content, with a known but custom schema.
I find this pretty confusing. There's a class called Content but that's not the class we use to represent "the actual content".
I think we should try to think of more self-explanatory names while we still can.
Perhaps ContentSource should become ContentReference.
If Content is an envelope, but is not the actual content, maybe it should be ContentEnvelope. With those two changes, ContentPayload could probably keep its current name.
The text was updated successfully, but these errors were encountered:
Contentactually is the content though. You can happily have the content without a payload and it is still content (content that is just metadata). I think calling it an envelope was probably not conceptually helpful. It is a "base for all types of content, implemented via containment".
In discussion a PR at #19 (comment) @mwadams wrote:
I find this pretty confusing. There's a class called
Content
but that's not the class we use to represent "the actual content".I think we should try to think of more self-explanatory names while we still can.
Perhaps
ContentSource
should becomeContentReference
.If
Content
is an envelope, but is not the actual content, maybe it should beContentEnvelope
. With those two changes,ContentPayload
could probably keep its current name.The text was updated successfully, but these errors were encountered: