Documents can either be stored in Holocentric or linked from an existing document management system. This article includes the following topics:

1. Add a document
2. Edit existing document
3. Approve document
4. Delete document 

1. Add a document 

1.1 Access the Documents tab, click on the Documents subtab and click Add a New Document. 

1.2 A release management workflow appears. Click OK to start adding the document. 

1.3 Link your document. You can either upload the document from your computer or add a link. 

1.4 Input all other relevant document details. 

Field	Description
Display name	The title that will be displayed.
Description	An introduction to the document.
External reference identifier	An identification code/number for the item. This can be used if the item is being mitigated from a different system or if a system of identifiers is required. This field is optional.
Summary	The short description that will appear under the document title when you are browsing Documents.
Roles this is relevant to	The roles associated with the document. You can use this to filter content for specific roles.
Category	The group to which the document belongs.
Required reading (for customers with Attestation only)	Tick this box to make this item required reading for all roles to which the item is relevant.
Keywords for 'Search'	Keywords that, when searched in the web app, will make the item come up in search results.
Remove from view	Tick the box to hide the item. This will make the item only visible to users with Administrator permissions. Hidden items will:  not shown in lists not shown as a related item on any other items.  not accessible by URL (will show item not found message) not shown in any downloadable report.

1.5 Click Save to commit changes. Your new document will be saved as a draft. We recommend that if you intend to make any changes, do so when the document is in a draft state. Move to the approval stage after you have made all intended changes. 

2. Edit existing document

2.1 Access the Documents tab and click the Documents subtab. 

2.2 Click on the document you wish to edit and Open Details.  

Please note: published versions can not be edited if a draft version is currently in progress. Edits will need to be done to the draft version. 

2.3 When open, click Edit to activate edit mode. If the document is already marked 'Awaiting Approval' or 'Ready to Publish', open the document details and revert it to a draft. 

2.4 Once changes have been made, click Save. The document will remain in draft. 

2.5 If all changes have been made, click Finish All Editing. 

A release management workflow appears. Write a summary of what you intend to change, you will be able to edit this summary later if needed.

2.5 Click Finish All Editing to commit all changes. Your document has now been submitted for approval. 

3. Approve document

3.1 Documents that have been submitted for approval will be marked as 'Awaiting Approval'. Click the Approval drop-down to view your options. You can revert the document to a draft if you want to make further changes. Click Approve when you are ready to publish your changes. 

3.2 A release management workflow appears. You have the option to select who approved the item, the date on which it was approved as well as the next review date. If required, edit your summary and click Approve to move to the publishing stage.  Your document is now marked ‘Ready to Publish’. 

TIP: If the document is part of a larger release (i.e. a release with multiple content updates), leave it marked ‘Ready to Publish’. When you are ready, you can publish it at the same time as your other content updates by accessing the Home tab and clicking Manage Changes. Please see the guide titled Publish multiple changes (in one release) for more information. 

 

3.3 Click Publishing to view your options. You can revert the document to a draft if you want to make further changes. Click Publish Immediately when you are ready to publish your changes. 

Note: You cannot edit older versions of the document once the latest version is published.

3.4 A release management workflow appears. If required, edit your summary and click Continue to move to the next stage. 

3.5 The release notes window appears. Write official release notes about the new document or document update. You can edit the release notes later if required.  

 

Field	Description
Label this release	The official name of this release.
Release notes	Details about what updates you have made.
Post a news item about this when the items are published	If selected, you can post a news item on the Home tab to notify users about your content changes.
News item title	Title of the news item that will appear in the Home tab.
News message	The message that will appear under the news item title.
Include link in release summary	If selected, this option will allow you to include a link to the release notes for the item.
Email all users when this News Item is published	If selected, all web app users in your organisation (provided they have activated their account) will receive an email notification about the release at 5:30 am AEDT/AEST the following day.

3.6 Click Publish to officially release the document. You will receive confirmation when the item is published. It is now visible to all users.  

4. Delete document

Document deletion within release management will be subject to a workflow similar to that which determines content editing and creation. Follow the steps below to delete a document from your web app.  

IMPORTANT: Once approved and confirmed, all deletions are permanent.

 

4.1 Click the Documents tab and access the Documents subtab. 

4.2 Click on the item you want to delete and click Delete.  

TIP: If the document is in a draft state (i.e. marked 'Draft', 'Awaiting Approval' or 'Ready to Publish'), clicking Delete will remove it without activating the deletion workflow. 

IMPORTANT: You will not be able to delete a published version of a document if it has a newer copy that is: in a DRAFT state, AWAITING APPROVAL, marked as ‘READY TO PUBLISH’, already marked for deletion.

4.3 A release management workflow appears. Give a summary of why you are deleting the document and click OK. Your item will now be marked ‘Awaiting delete approval’. 

4.4 To approve the item for deletion, click on the item in the list, and click Open details.

4.5 Click Approval to see your options. At this stage, you can still reverse the deletion. Click Revert (Don’t Delete) if you want to do so. If you want to proceed with the deletion click Approve Deletion.  

4.6 A release management workflow will appear. You also have the option to select who approved the deletion and the date on which it was approved. Edit your summary (if required) and click Approve.  

4.7 When you have approved the deletion, you can permanently delete your item. The item will be marked ‘Delete on Publish’. Click Open Details again.  

TIP: If the deletion is part of a larger release (i.e. a release with multiple content updates), leave it marked ‘Delete on Publish’. When you are ready, you can publish it at the same time as your other content updates by accessing the Home tab and clicking Manage Changes. Please see the guide titled Publish Multiple Changes  for more information. 

4.8 Click Publishing to see your options. At this stage, you can still reverse the deletion. Click Revert (Don’t Delete) if you want to do so. If you want to proceed with the deletion click Delete Immediately.  

4.9 A release management workflow will appear. Edit your summary (if required) and click Continue. 

Write release notes for the deletion. Release notes are the official overview of all your changes and updates.

Field	Description
Publishing	The official name of this release.
Release notes	Details about what updates you have made.
Post a news item about this when the items are published	If selected, you can post a news item on the Home tab to notify users about your content changes.
News item title	Title of the news item that will appear in the Home tab.
News message	The message that will appear under the news item title.
Include link in release summary	If selected, this option will allow you to include a link to the release notes for the item.
Email all users when this News Item is published	If selected, all web app users in your organisation (provided they have activated their account) will receive an email notification about the release at 5:30 am AEDT/AEST the following day.

 

5.0 Click Publish to permanently delete the item.