KB User's Guide - Documents Tab - Viewing Documents in Review Mode

This document details the functionality available when viewing a document in read-only mode.

Viewing Documents in "Review Mode"

If you wish to look at the content of a document without making any changes, open a specific status queue; Active, In Progress, In Review.. and click on the document title to view it in read-only mode/Review Mode. Review Mode also allows you to see what edits and comments have been made to a document of any status.

Getting to Review Mode

In the image below, we navigated to the KB Admin Tools > Document tab > Active Documents screen. We were presented with a table of all Active documents in the queue. Clicking on the document link, "Ford 1926 Model T Coupe" will lead to the Review Mode of that specific document.

Active documents screen with arrows highlighting the Active navigation button on the left, the Active Documents title, and the document title link

The image below shows the Review Mode of document 28290. From here, we see the document content in read-only mode. The Edit button is accessible on the upper left corner, which means this user has permissions to Edit. Notice the buttons next to the Edit button; Mark as reviewed, Save as, See revisions, view source and Export as XML.

Ford 1926 Model T Coup Document with arrows highlighting the document's active status

Buttons in Specific Status Queues

The option buttons available will vary depending on the Status Queue of the document you are viewing. The images below show the options available in each specific queue: Follow the navigation:  KB Admin Tools > Documents tab > X status queue > click on a link of a specific Status queue to view the option buttons. Those without Publish rights will not see the Publish nor Delete buttons. The Mark as reviewed button appears regardless of document status, as long as the user has write access to the document. Additionally, the button will not appear if the document is owned by another group space.

  • Active: Edit, Mark as reviewed, Save as, See revisions, View source, Export as XML  

    Buttons available when document's status is active


  • In Progress: Edit, Mark as reviewed, Save as, See revisions, View source, Export as XML, Delete

    Buttons available when document's status is In Progress

  • Active Status Queue - document in Dual Status (e.g. document is both Active and In Progress): Edit, Mark as reviewed, Save as, See revisions, View source, Export as XML, Draft vs Active, Delete

    Buttons available when document's status is In Progress/Active

  • In Review: Edit, Publish, Mark as reviewed, Save as, See revisions, View source, Export as XML,  Draft vs Active, Delete

    Buttons available when document's status is In Review

  • In Review Status Queue - document in Dual Status (e.g. document is both Active and In Review): Edit, Publish, Mark as reviewed, Save as, See revisions, View source, Export as XML, Draft vs Active, Delete

    Buttons available when document's status is In Review/Active

  • Inactive: Edit, Mark as reviewed, Save as, See revisions, View Source, Export as XML, Delete

    Buttons available when document's status is Inactive

  • Trash: Edit, Mark as reviewed, Save as, See revisions, View source, Export as XML

    Buttons available when document's status is Deleted

Find a Document  Two Ways:

  1. If you know the document ID number of the document you wish to view, click the Documents tab in KB Admin Tools and enter the document ID number either:
    • in the ID # field in the left side navigation menu, click the Go button next to ID # field
    • or in the Find: field on the Documents screen and click the Go button on far right hand side.

      Documents in Review Screen with arrows highlighting fields where you can enter a document id, one in the left nav bar, one in the filtering fields


      Scroll to the bottom of the page to see important metadata and comments related to this document by clicking Show comments and events arrow. Click on the Hide comments and events arrow to hide this information.

      Comments and Events field, with dropdown arrow on the top right

  2. If you do not know the document ID number, you can search for the document by entering the search criteria in the Find field and clicking Go. In the image below, a red arrow is pointing to the Search term field in the Active queue.

    active documents screen with an arrow highlighting the search term field

    A list of documents matching the search will be displayed. To view any of those documents in Review mode, click on the document title link. For more information on searching documents, see KB User's Guide - Documents Tab - Document Searching and Sorting.

Review Options/ Comments

Adding Comments and Sending Comments to Owner - Documents with the Status of Active

If you would like to add notes for informational purposes to an Active document, you can do so by opening the document in Review Mode in KB Admin Tools > Documents tab Scroll down to the bottom of the page and select option number 1, "Leave document XXXX as is and add comments to only." in the Review Options / Comment section at the bottom of the document page. This adds your comment to the document event log, but does not alter the live document in any other way.

  1. Select  1) Leave document as is and add comments only option in the Review Options / Comment section at the bottom of the document page.
  2. Enter notes in the text field provided.
  3. If you do not want to email your notes to the owner leave the Send comments to owner checkbox unchecked. If you wish to send your comments to the document owner, check the Send comment to owner checkbox.
  4. Click on Submit button.
Review Options / Comments options with the Leave documents as is and add comments only option selected

Adding Comments and Sending Comments to Owner - Documents with a Status other than Active

If you would like to add notes for informational purposes only to a document that is not active (In Review, In Progress, Inactive), you can do so by opening the document in review mode in KB Admin Tools > Documents tab (see above for more info about opening a document for review). In the Review Options / Comment section at the bottom of the document page. This adds to the document event log, but does not alter the live document in any other way.

  1. Select 1) Leave doc as is and add comments to the doc option in the Review Options / Comment section at the bottom of the document page.
  2. Enter notes in the text field provided.
  3. If you do not want to email your notes to the owner leave the Send comments to owner checkbox unchecked. If you wish to send your comments to the document owner, check the Send comment to owner checkbox.
  4. Click on Submit button.
Comment text field, Send comments to owner option circled in red

A Note About Comments

You do not need to enter comments in order to use the following buttons: Mark as reviewed, Save as..., See revisions or View Source . Please note that a document needs to be set to either "In Progress" or "In Review" before it can be reverted to a previous version using See Revisions.

Comments may be required to edit a document (when the Submit button is clicked). Whether or not comments are required is set at the Site level in the Settings tab > Group Spaces link > Review> Click on the Edit link at the far right of your Groups Space> check/uncheck Require review comment link.

Review Mode Buttons

Mark as reviewed Button

The Mark as reviewed button (only available for documents you have write access to) allows you to indicate that you have checked the document content and no changes are required at this time.

Review Options / Comment screen with the Mark as Reviewed button circled in red

A pop-up message will appear asking, "Are you sure you want to mark this doc as reviewed? If the document expires in less than 180 days (6 months), its expiration date will be set to 180 days from today." Confirm this by clicking OK or exit without making any changes by clicking Cancel. If you click OK you will not be reminded to review this document for another 6 months.

Pop up confirmation message

Save As...

The Save As... button allows you to create a new draft document from an existing draft of any Status.

Review Options / Comment screen with the Save As button circled in red

To use Save As..., simply open an existing in Review Mode in KB Admin Tools and click on the Save As... button. You will be asked to confirm that you want to copy the document. Click OK to continue.

See Revisions

The See Revisions button allows you to view the changes that have been made to a document. Different versions of a document can be compared side by side. See KB User's Guide - Documents Tab - How To View Revision History for more info.

Document Revisions screen with several of the latest revisions listed

You may choose to save a document revision as a new document. You can retrieve content from a prior version of a document and activate it as a separate doc by clicking on the Save this version as a new document button at the very bottom of the window .

Options on the bottom of the document revisions screen with the Save this version as a new document option circled in red

View Source

The View source button allows you to view the source HTML and gives you a read-only view of the source HTML for the following fields: Title, Keywords, Summary, Body.

Source code view showing the HTML code for a KB User's guide document

Export as XML

The Export as XML button allows you to export the document in its entirety as an *.xml file.

Document Review screen with the Export as XML button circled in red, arrow pointing to the document xml file that has been downloaded

Delete

If the document is not "Active" and you either own the document or have publish rights (set by KB Admin on Users Tab), you will see a Delete button. It allows you to discard the document. The document will be moved to Trash and no longer be viewable or searchable. A deleted document can only be recovered from the Trash by a KB Admin with publish rights. See also KB User's Guide - Documents Tab - Changing a Document's Status to "Deleted".




Keywords:kb knowledgebase knowledge base users guide livedocs live docs document documents tab review reviewing save as send comment to owner Mark as reviewed See revisions show changes button mark as reviewed notification review reminder extend expiration date   Doc ID:5251
Owner:Leah S.Group:KB User's Guide
Created:2007-01-04 19:00 CDTUpdated:2023-06-01 16:55 CDT
Sites:KB Demo, KB Demo - Child Demo KB, KB User's Guide
Feedback:  0   0