Merge pull request #37 from directus/writeup/content

Write up Content section

Author: phazonoverload

content/3.content/1.explore.md

@@ -1,22 +1,61 @@
 ---
-description:
+description: Learn to filter, layout, batch edit and more with collections in the collection explorer.
 ---
 
 # Collection Explorer
 
 The content module allows users to browse, filter, and search for items held in collections. When users navigate into viewing single items, they use :product-link{product="editor"}. Each page contains data from a single collection, but can display related fields for each item.
 
+To open the collection explorer, click on the content module on the left hand side of the page.
+
 <!-- TODO: IMAGE OF EXPLORE -->
 
 ## Filtering Items
 
+<!-- TODO: IMAGE OF FILTERS -->
+
+You can create custom filters to display items that fulfill certain criteria.
+
+Click on :icon{name="material-symbols:filter-list"} at the top of the page to create a filter. You can then select a field to filter by and click on the criterion to tweak what should pass for that item to be filtered.
+
+### And / Or Groups
+
+`AND` groups give the option to filter for items that meet all of several criteria. On the other hand, `OR` groups filter for items that meet any one of several criteria.
+
+In order for filters to be included in `AND` or `OR` groups, filters must be indented below them in the filter UI.
+
+### Dynamic Variables
+
+<!-- TODO: Image -->
+
+The following dynamic variables are built into Directus to add extra functionality to filters: 
+
+- **`$CURRENT_USER`** — The primary key of the currently authenticated user.
+- **`$CURRENT_ROLE`** — The primary key of the role for the currently authenticated user.
+- **`$CURRENT_ROLES`** - An array of roles containing the `$CURRENT_ROLE` and any roles included within it.
+- **`$CURRENT_POLICIES`** - An array of policies assigned to the user directly, or through their roles.
+- **`$NOW`** — The current timestamp.
+- **`$NOW(<adjustment>)`** - The current timestamp plus/minus a given distance, for example `$NOW(-1 year)`, `$NOW(+2 hours)`.
+
 ## Layouts
 
+Layouts are customized mechanisms for viewing and interacting with the items in a collection. You can [select a layout](/content/layouts) for displaying your collection. Note that restrictions will apply depending on your collection's [data model](/data-modeling/collections).
+
 ## Batch Editing
 
-## Layout Presets
+<!-- TODO: Image -->
+
+By selecting more than one item in the explorer will allow you to click on :icon{name="material-symbols:filter-list} and edit several items' fields at once to have the same value.
+
+## Bookmarks
+
+<!-- TODO: Image of explorer with bookmarks -->
+
+Bookmarks are custom views for your collections that include specified configurations, layouts, visible fields, sorting, filtering and more.
+
+To create a bookmark, navigate to the Settings -> Bookmarks module. Here, you can create a new one by clicking on :icon{name="material-symbols:add-circle-outline-rounded"}.
 
-## Access Control
+You'll see the "Editing Preset" form, where you can set the name and collection, amongst layout and other values for this bookmark. Note that leaving the name field empty will make it so this bookmark is what is viewed for this collection by default.
 
 <!--
 

content/3.content/2.editor.md

@@ -1,34 +1,86 @@
 ---
-description:
+description: Learn to create, duplicate, archive and perform other actions with items using Directus.
 ---
 
 # Item Editor
 
-<!-- PREAMBLE ABOUT EDITOR -->
+The item editor is a tailored form for managing individual items and their field values.
 
 <!-- TODO: IMAGE OF EDITOR -->
 
 ## Fields & Data Model
 
-<!-- Small copy, link to data modeling items -->
-<!-- Half/full width, Hidden fields from data modeling settings -->
+You can add fields to items by [configuring the collection's data model](/data-modeling/fields). Here, you can also configure how the fields are displayed in the item editor.
 
 ## Creating Items
 
+To create an item, click :icon{name="material-symbols:add-circle-outline-rounded"} in the page header to open the item page.
+
+Fill in the fields as desired. Note that some of these will be [marked as required](/data-modeling/fields) and need to be filled in, or be dynamic fields. Relations will be filled in here, too.
+
+::callout{type="info" title="Singletons"}
+
+If the collection is configured as a [singleton](/data-modeling/collections) in the data model
+settings, the App will automatically open the item page when selecting the collection.
+
+::
+
 ## Duplicating Items
 
-<!-- Save as copy when small change -->
+<!-- TODO: IMAGE -->
+
+When editing an item, you can click on :icon{name="material-symbols:more-vert"} to select some advanced options, amongst them "Save as Copy". Selecting this will save a copy.
 
 ## Archiving Items
 
-<!-- 'soft delete' -->
+To archive an item, follow these steps, navigate to the content module and select the desired collection. Select the desired item to open the item editor. Click :icon{name="material-symbols:archive"} located in the header and a popup will appear to confirm the action.
+
+Archived items will not show up in search results or be returned in API responses. They still exist and can be retrieved using specific queries. Archiving can therefore be seen as a form of "soft deleting" an item.
+
+::callout{type="info" title="Requires Configuration"}
+
+Archiving requires an [archive field](/data-modeling/collections) to be configured within the collection's data model
+settings.
+
+::
 
 ## Revisions
 
+<!-- TODO: IMAGE -->
+
+As you update field values on items, Directus saves these revisions, and they can be compared side-by-side to the current state.
+
+To revert an item, navigate to the content module and select the desired collection and select the desired item. Click on "Revisions" in the editor sidebar and then on the revision you wish to preview. Go to "Revisions Made" in the side menu and view the revision differences. Click :icon{name="material-symbols:settings-backup-restore"} to revert the item's values and return to the item page.
+
+::callout{type="info" title="Revision Preview"}
+
+You will also see a "Revision Preview" button in the side menu navigation, which will let you preview all the item's
+values for that revision.
+
+::
+
+::callout{type="info"}
+
+You can also revert items [programmatically via the API](/api-reference/system/revisions).
+
+:::
+
 ## Comments
 
+<!-- TODO: IMAGE -->
+
+You can add comments to items in the sidebar by clicking on "Comments", which will show the form for submitting one. You can use the @ button to tag specific users in your comment.
+
 ## Shares
 
+<!-- TODO: IMAGE -->
+
+You can create shareable links to view an item in the sidebar by clicking on Shares -> New Share.
+
+Here, you can specify the name, password, roles allowed to access the item, as well as the start and end dates for the link's validity, followed by the maximum times a link can be used.
+
+To share the link, click on the new share's :icon{name="material-symbols:more-horiz"} and select either "Copy Link" or "Send Link". You can also edit or destroy the share in this menu.
+
 ## Next Steps
 
-<!-- Link to Content Versioning, Live Preview -->
+Learn how to use [content versioning](/content/content-versioning) and the [live preview](/content/live-preview) functionality.