-
Notifications
You must be signed in to change notification settings - Fork 64
Write up Content section #37
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
❌ Deploy Preview for directus-docs-v2 failed. Why did it fail? →
|
phazonoverload
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good. Mostly small changes. Global comments:
- Watch random capitalization.
- TODO all comments with images that need creating so we don't lose them.
content/3.content/1.explore.md
Outdated
|
|
||
| <!-- TODO: Image --> | ||
|
|
||
| The following dynamic variables are built into Directus to add extra functionality to filters: `$CURRENT_USER`, `$CURRENT_ROLE`, `$CURRENT_ROLES`, `$CURRENT_POLICIES`, `$NOW` and `$NOW(<adjustment>)`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Go through and explain what each one is. I'd also be clear that CURRENT_ROLES and CURRENT_POLICIES are arrays
content/3.content/1.explore.md
Outdated
|
|
||
| ## Layouts | ||
|
|
||
| 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). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'd briefly explain more what these are. I know that it's a whole page, but I don't think this helps people understand them
content/3.content/1.explore.md
Outdated
| ## 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Mention that this is to the same value.
content/3.content/1.explore.md
Outdated
|
|
||
| <!-- TODO: Image of explorer with bookmarks --> | ||
|
|
||
| Bookmarks are custom layouts that can be displayed for different views of your collections. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not quite. They specifically include more than layouts - also config, visible fields, sorting, filtering, search.
|
|
||
| Promoting a version will turn it into the main version. | ||
|
|
||
| Open the version you want to promote and select the "Promote Version" option from the dropdown. In the "Changes" tab, you can review all the changes made in the version and decide which changes to accept or reject. Switch to the "Preview" tab to see a preview of the changes you are about to promote. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
More here - for each field you can choose to include it in the promotion or leave it. I'd add an image here too. It's a cool interface.
| Some Directus users combat this by periodically purging some or all data in this collection. Be aware that this could | ||
| unintentionally purge content versions. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This feels scary. It's important, but is there any way we can soften this?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This page also needs, somewhere, mention that version is a dynamic variable that can be added to the live preview URL so you can preview a specific version. And then link back maybe to live preview?
content/3.content/7.translations.md
Outdated
| There are two ways to change the app language. First, administrators can set the project's | ||
| [default language](/configuration/translations). Second, users can choose their own personal | ||
| language preference. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove first and second. Conciseness is key.
Co-authored-by: Kevin Lewis <kvn@lws.io>
Co-authored-by: Kevin Lewis <kvn@lws.io>
Co-authored-by: Kevin Lewis <kvn@lws.io>
Co-authored-by: Kevin Lewis <kvn@lws.io>
Co-authored-by: Kevin Lewis <kvn@lws.io>
Co-authored-by: Kevin Lewis <kvn@lws.io>
Co-authored-by: Kevin Lewis <kvn@lws.io>
|
Thanks for the review! I think I've caught everything here. Can you please take another look? |
| - **Version**: a version is a snapshot of the differences between the original item and the created version. Each | ||
| - version represents a set of future changes to be applied to the item. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is outstanding
No description provided.