The main content you manage with Dossier is entities. An entity has a unique id, so it can be referenced from other entities, and a unique name, which makes it easier to distinguish from other entities. An entity has one or more fields containing data. Changes to an entity creates a new version so you can always go back in time to look at when changes were made and what changed.
An example of an entity is this article, it has the following properties:
Each entity has an entity type that defines the structure of the entity and its fields. That means that all entities of the same type will have the same fields. This article has the entity type "Article".
Another property of an entity is the authorization key, which defines who can read or write to the entity. We'll get back to authorization keys later, but for now it's enough to know that this article has the key "none", which means that anyone can read it.
In addition to creating and changing the content of entities, you can also perform a number of publishing actions on an entity. Each action modifies the status of the entity. These are the actions that are available:
modifiedif there are newer versions of the entity that haven't been published
withdrawnif it has been previously published
As of now you can't delete an entity which means you will never lose content since old versions are stored forever. The closest to deleting is archiving, so you can ensure you don't accidentally publish it in future.
Similarly to entities, you can also use components for structured data. Components have fields just as entities, but you can't manage components on their own, they need to be part of an entity. A component can also be part of another component, which enables you to create more complex data.
An example of where a component is used is in the menu to the left on this page. The menu is stored in an entity with the entity type "Chapter". In its "items" field there is a component representing this article. The component has the following fields:
Each component has a component type that defines the structure of the component and its fields. The component representing this article in the menu, has the component type "ArticleTocItem".