Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Docs updates to coincide with 11.13.0 feature and bug fixes #479

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

Draft
JamesW1 wants to merge 7 commits into main
base: main
Choose a base branch
Loading
from release/11.13.0

Conversation

@JamesW1
Copy link
Contributor

@JamesW1 JamesW1 commented Oct 9, 2025
edited
Loading

  • add clarity on exporting schema to assist with bug reproduction - new export button in Settings > Data Model
  • add notes on updates to version/revision comparison modal
  • remove beta badging from MCP docs
  • document new PROJECT_OWNER env variable and update quick-start/deploy docs

formfcw reacted with heart emoji
... export button available coming in 11.13.0
Copy link

vercel bot commented Oct 9, 2025
edited
Loading

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Oct 29, 2025 6:27pm

Co-authored-by: daedalus <44623501+ComfortablyCoding@users.noreply.github.com>
Copy link
Contributor Author

JamesW1 commented Oct 28, 2025

@robluton @formfcw - see updated notes on the content versioning page regarding versions, revisions and comparison.

- **Version**: a version of an item is a snapshot that gets copied from the current or `main` version, allowing you to safely make changes and later promote to be the main version. Any changes to the main version made in the meantime are updated automatically.
- **Main**: the main version is the original version of a piece of content that has been created. It is the default version that is displayed to users. The main version is the "source of truth" for all other versions. This is often used for published content.
- **Promote**: promoting a version means to make it the new main version. When a new version is promoted, it becomes the main version that is displayed to users, and it replaces the previous main version.
- **Revision**: revisions are individual changes to items made within a version. Directus keeps track of all changes made, so you're able to view the history of modifications and revert to a previous state at will.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Revision**: revisions are individual changes to items made within a version. Directus keeps track of all changes made, so you're able to view the history of modifications and revert to a previous state at will.
- **Revision**: revisions are individual changes to items made within a version. Directus keeps track of all changes made, so you're able to view the history of modifications and revert to a previous state.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

made within a version ... revisions can also be made within "Main"

a version of an item is a snapshot that gets copied from the current or main version, ... it is not a snapshot and nothing get’s copied. Not the "current", only the "main" version.

## Concepts

- **Version**: A version of an item is a snapshot that gets copied from the current or `main` version, allowing you to safely make changes and later promote to be the main version. Any changes to the main version made in the meantime are updated automatically.
- **Version**: a version of an item is a snapshot that gets copied from the current or `main` version, allowing you to safely make changes and later promote to be the main version. Any changes to the main version made in the meantime are updated automatically.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again, I know this isn't part of the new docs, but I think we should remove the sentence "Any changes to the main version made in the meantime are updated automatically." I don't think it's necessary, and some may think this means changes made to main are automatically updated on the versions.

Suggested change
- **Version**: a version of an item is a snapshot that gets copied from the current or `main` version, allowing you to safely make changes and later promote to be the main version. Any changes to the main version made in the meantime are updated automatically.
- **Version**: a version of an item is a snapshot that gets copied from the current or `main` version, allowing you to safely make changes and later promote to be the main version.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@robluton robluton robluton left review comments

@ComfortablyCoding ComfortablyCoding ComfortablyCoding left review comments

@formfcw formfcw formfcw left review comments

Assignees

No one assigned

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

AltStyle によって変換されたページ (->オリジナル) /