Publishing Process

Revision moderation and roles

Workbench Moderation will be used to facilitate a publishing process for best practices defined within this site.  Content will transition from Draft to Needs Review to Published status.  A revision history of the content will be retained.  Users with the Content Editor role are able to create and/or update content within the site.  Users with the Content Admin role have all the same permissions as a Content Editor; in addition they are able to review and publish new and updated content.  Each ITS group providing content for this site will need to designate specific individuals for the Content Editor and Content Admin roles; Content Editors and Content Admins should be separate individuals.  Contact the Site Administrator to have a roles assigned to specific individuals. 

Migration flow

Any type of content may be included within the site; however, in general specific best practices will be described within book pages that are grouped into books of related best practices.  When a new page is created or an existing page is modified the new revision of the page will go into the Draft status by default.  When the page is ready to be reviewed it should be moderated into the Needs Review status, i.e on the View draft tab select Needs Review from the Moderate dropdown and click the Apply button.  A designated set of managers will review the page.  If it needs further work it will be moderated back to the Draft status so that further changes can be made.  When the page is ready to be made active a Content Admin will moderate it to the Published status.  Pages within either the Draft or the Needs Review status have limited visibility (i.e., visible only to Content Editors and Content Admins).  Pages in the Published status are visible to all users.  

Page visibility within book navigation

A page within a book will not be visible within the book navigation until it has a status of Published.  Hence if a new page is created and is in either the Draft or Needs Review status, it will not be visible by navigating through the pages of the book.  In order to make that possible, create the new blank page first with only a title and with something like "<to be defined>" or "<Under Construction>" as the content, save it, moderate it to Needs Review status and ask a Content Admin to moderate it to Published.  That essentially creates a placeholder page but, it also adds that page to the book navigation and makes it visible for editing.  At that point you can go back and update the page by adding the real content to it and moderating it through the Draft, Needs Review, and Published statuses.   

Best practice text formatting

Formating a typical page containing best practice(s)

entering
Optional introduction.
<dl class=bestp>
     <dt>Text of best practice.</dt>
            <dd>Text of justification of best practice.</dd>
     <dt>Optional second best practice ... ect.</dt>
            <dd>Text of second justification of best practice.</dd>
</dl>
<dl class=atunl>
     <dt>What we do here</dt>
            <dd>Text or links related to UNL's implementation of these practices. Links to related UNL's Policies.</dd>
</dl>
becomes

Optional introduction.
Text of best practice.
Text of justification of best practice.
Optional second best practice ... ect.
Text of second justification of best practice.
What we do here
Text or links related to UNL's implementation of these practices. Links to related UNL's Policies.