Page Comparison

...

• If it is a policy that currently exists, sometimes it is easier to clone the version that is currently online.
  1. Navigate to the list of policies. From the dashboard, choose Content > Policies from the left side menu.
  2. Find the policy you want to clone from the list. The easiest way to do this is to search for the name of the policy (searching for the number doesn’t work). Edit the policy.
  3. In the “Policy Identifiers” box, check the box next to “Policy Under Review.” This will mark it as under review in the table of policies.
  4. In the “Publish” box, choose the “Copy to a new draft” link.
• If you are adding a brand new policy, create a new policy and add the meta data:
  1. Navigate to the list of policies. From the dashboard, choose Content > Policies from the left side menu.
  2. Click the “Add New” button.
  3. In the “Policy Identifiers” box, add the Policy Number.
  4. In the “Section Number” box, choose the correct series.
  5. If this is a Procedure, Guidance or GuidanceQuestions, in the “Attributes” box, add the Parent. The parent should be the associated Policy. The Parent must be published before it will be available to choose.  
  6. If it is Guidance or Questions, choose "Guidance" the appropriate option from the "Child Type" dropdown in the Policy Identifiers metabox. This option will only display once you have chosen a Parent.
• If the text or heading structure is totally new, delete the text that currently exists and copy the whole Word Document into the editor.
  1. Use “Paste as Plain text” by choosing the icon that looks like a clipboard from the second bar of the toolbar.
  2. If the text hasn’t changed that much, you can copy and paste only specific sections.
• If there are paragraphs that are the wrong font, highlight them and use the Eraser icon in the toolbar to delete the other formatting.
• Update the text to include the heading formatting.
  1. Headings should be semantic, the first level headings should be H2’s, second level headings H3, etc.
  2. Headings should be in title case, not all upper case. H4s and H6s will automatically display as all upper case. That is alright.
• Delete extra line breaks and other spaces.
  1. Sections should not be indented.
  2. There should not be blank lines between paragraphs or headings.
• Add the definitions to the policy.
  1. In the definitions metabox, add the definitions. If definitions are too long to be displayed in a tooltip, or contain rich text like bulleted lists, you'll need to include "See complete definition in policy" at the end of it.
     
  2. If no definitions were concatenatedcondensed, you can replace the definitions in the policy text with "[policy_definitions ]". This will display the definitions formatted for the policy.
     
• Add hyperlinks to statutes, other policies, regulations, and guidance in the policy text and Related Documents section.
  1. The links for the UW System Policies can be found here: https://www.wisconsin.edu/uw-policies/uw-system-administrative-policies/
  2. The links for the Regent Policies can be found here: https://www.wisconsin.edu/regents/policies/
  3. The links for the Wisconsin Statues can be found here (although sometimes it is easiest to just Google the statute number): https://docs.legis.wisconsin.gov/statutes/statutes
  4. Google other items or ask Stefan.
• Update the meta data of the policy:
  1. Confirm that the right Section Number is selected. The correct section number is determined based on the policy number.
     
  2. In the “Page Security” box, choose “UW All” to require a login to view the policy.
     
  3. In the “Policy Display Settings” box (near the bottom of the page):
     1. Select the “Hide form the Policy List” checkbox. This allows us to publish the policy without the policy displaying on the main list of policies.
     2. In the “Pre Policy Title Header Text” enter “Draft Policy.”
  4. In the “Policy Identifiers” box, make sure “Policy Under Review” is not checked.  Draft policies should not also be marked as under review.
  5. In the Policies Contact Box, select the appropriate contacts from the drop down menu. If the contact hasn't been added before, use the Add New Contact link.
     
  6. Use the “Save Draft” or “Update” button in the publish box to save your changes.
• Make the “Track Changes” PDF, upload it to the website, post at the top of the draft policy:
  1. Save the “Track Changes” and “Summary of Changes” documents as PDFs.
  2. Add them to the document collection:
     1. Navigate from the dashboard to Collections > Documents > Files.
     2. Click “Add New” button at top of page.
     3. Click the “Select Files” button and choose the document you want to upload from your computer.
     4. Update the title to be human readable (eg. SYS 342 Summary of Changes)
     5. Select the category of “Draft Policy Documents”
     6. Click the “Add File” button.
     7. Repeat for any other documents.
  3. Link to the document from the policy.
     1. Edit the draft policy.
     2. At the top of the policy, add the text, “Also see the ”
     3. Add the document by clicking the “Site Files” button (looks like a stack of papers) from the toolbar. Choose the document that you just uploaded. You can search for it by the title you gave it.
     4. Click the “Insert” button.
  4. Highlight the text with a notice.
     
     1. Select the text you just added.
     2. On the second row of the toolbar (use the toggle toolbar button if you don't see the second row), use the "Formats" dropdown to select Alerts > Warnings. Text will be highlighted with a yellow background.
  5. Use the “Save Draft” or “Update” button in the publish box to save your changes.
• Publish the policy by using the “Publish” button in the top right.

...

Note: The below instructions describe how to replace the existing policy with a new version of the policy. If the change is small (like a short technical change)only to the text of the policy, then it may be easier to edit copy the text of the draft into the text of the existing policy. To do that, navigate to the existing policy and choose the "Edit Policy" button in the header. Delete any draft policies used for comment.

• Update the text of the policy based on the signed copy of the policy. Stefan should be able to supply a Word Document copy of the final text.
• Remove the reference to the “Track Changes” and “Summary of Changes” documents from the top of the policy.
• Confirm that links and heading styles are still in place. See above for more details.
• Update the “Last Revised Date” in the “Policy Identifiers” box.
  
• Delete the “Track Changes” and “Summary of Changes” documents from the document collection:
  1. Navigate from the dashboard to Collections > Documents > Files.
  2. Hover over the documents associated with the policy and choose “Delete.”
• Disable the comment form:
  1. Navigate from the dashboard to Collections > Forms.
  2. Click the green slider next to the form associated with the policy. It should be grey to signify the form is disabled.
• Delete the version of the policy that is being replaced:
  1. Open the version of the policy that is being replaced.
  2. Print it as a PDF. Include the date in the name of the PDF and put it in the correct folder on the shared drive.
  3. Note the URL of the policy.
  4. Delete the old policy by editing it and choosing “Move to Trash.”
• Publish the new version of the policy:
  1. Edit the new version of the policy.
  2. Update the URL of the new version to match the old URL. (Skip this step if the policy name has changed.) Choose “Edit” next to the URL under the title of the policy.
  3. In the “Page Security” meta box, choose “(inherit).”
  4. In the  “Policy Display Settings” meta box update:
     1. “Hide from the Policy List” is unchecked.
     2. “Pre Policy Title Header Text” is blank.
     3. "None” in the Comment Form Dropdown.
     4. “Notice Text” is blank.
     5. “Comment Due Date” is blank.
  5. Save the policy. It should now be visible from the main list of policies.
• Update any children of the policy to point to the new version of the policy.

Add a Policy Update to announce a new policy is approved

...