Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/deposit/images/edit-record.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/deposit/images/header-my-dashboard.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/deposit/images/new-version-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/deposit/images/record-versions.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/deposit/images/uploads-page.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/deposit/images/uploads-shared-with-me.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
88 changes: 88 additions & 0 deletions docs/deposit/published-records.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,99 @@
# Published records

Published records are finalized records made available in the repository. Once a record is published, it becomes accessible to other users.

!!! note

A *published record* is not necessarily a *public record*.
Publishing a record means the record is no longer a draft (a temporary working version) but a finalized record registered in the system.
Whether the record is publicly accessible depends on its restriction settings.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I am thinking to add a small glossary page with some names, to which we will link when describing things.
Here I would like you to add a disclaimer (like a box with differrent color so it stands out)

Please note published record is not equal to a public record. Published record means that record is no longer a draft (temporary working version) but finalised record, registered fully in the system.

A published record contains finalized metadata and associated files. It also displays additional information such as:

- usage statistics
- versions
- communities
- citation details

## Your records

To see all your records, go to **My Dashboard**.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

I think we can add links as well! WDYT?


![My Dashboard header](images/header-my-dashboard.png "My Dashboard header")

The **My Dashboard** page shows all records you have created or contributed to, including published records and drafts.

From this page you can:

- view your published records
- access and continue editing draft records
- monitor the status of your uploads
- search and filter your records
- create new uploads

Each record entry displays key information such as the title, status ('open' or 'restricted'), and the last update date.

Published records are indicated by a green checkmark, while draft records (temporary working versions) are shown with a red upload icon.

![Uploads page in My Dashboard](images/uploads-page.png "Uploads page in My Dashboard")

## Records shared with you

Records can be shared with you by other users, allowing you to view or collaborate on them.

To access these records, go to **My Dashboard** > **Uploads** and select the **Shared with me** tab.

Shared records may allow different levels of access depending on the permissions granted to you by the record owner.

![Shared with me tab in Uploads](images/uploads-shared-with-me.png "Shared with me tab in Uploads")

## Edit

Draft records can be edited at any time before they are published.

To edit a draft:

1. Open the draft from **My Dashboard** > **Uploads**.
2. Update the metadata or files as needed.
3. Save your changes.

For published records, only the metadata can be edited.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

question: are we not allowing the use of the new file modification feature on CDS?


To edit metadata of a published record:

1. Open the published record you want to modify.
2. Click **Edit**.
3. Update the metadata.
4. Save and publish the changes.

![Edit action on a published record](images/edit-record.png "Edit action on a published record")

If you need to modify or replace files, you must create a new version of the record.

## New version
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Do we want to mention here how DOIs work with new versions? I.e. whether you need to manually request one, and how there is a DOI for the parent record. Or should this go on a different page?


To modify the files of a published record, create a new version.

To create a new version:

1. Open the published record.
2. Click **New version**.
3. A draft copy of the record is created.
4. Update the metadata or files as needed.
5. Publish the draft to release the new version.

![New version button on a record](images/new-version-button.png "New version button on a record")

CDS keeps a version history, so all previous versions remain accessible.

All versions are linked together, allowing users to navigate between older and newer versions of the same record.
Copy link
Copy Markdown

@sakshamarora1 sakshamarora1 Mar 27, 2026

Choose a reason for hiding this comment

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

It seemed odd to read from 3rd person perspective speaking about "users" given that in other places we say "you"

Suggested change
All versions are linked together, allowing users to navigate between older and newer versions of the same record.
All versions of a record are linked together, allowing you to navigate between older and newer versions.

Also, can we mention about searching for all versions? The toggle on the search page. Users has dome some doubts about it


!!! tip

To learn more about how DOIs work with record versions, see the [DOI versioning FAQ](https://repository.cern/help/versioning).

![Record versions section](images/record-versions.png "Record versions section")

## Delete

You cannot delete a published record. Deletion is allowed according to the [Content Policy](https://repository.cern/content-policy).
Expand Down