As a policy analyst or contractor, I need to get manager approval before I my document.

Question

austinhernandez opened this issue 6 years ago · comments

Assumptions

The user is done proofreading and editing a policy and needs a manager or SME approval before the a policy live on the OMB Policy Library.

Create mechanism for "in review" or "approval."
Design warning label, button, or screen that alerts a user that they need approval
Notify user of success (screen, alert, etc.)
Determine if the documents needs an "in review" status.
Publish button gives clear language and understanding to the publisher that this is final and will be public
Finalize text and applicable error states
Design applicable warning labels, buttons, or screen that alerts a user that they need approval

The approval process will start to get more complex, but MVP as defined by stakeholders and team indicated the review process will an "over the shoulder" design review. We just need to make sure there are barriers in place to reduce error in public facing documents.

As a SME or supervisor, I want to be able to track changes to policy documents and be able to revert to old versions, so that we can correct any mistakes that might be introduced.
As a SME or supervisor, I want a feature that allows my Policy Analysts to notify me by email with a direct link to the policy in question when something is ready for review to be published so that I can easily track, approve, and publish documents.

Austin Hernandez · Answer 1 · Sat Feb 10 2018 05:35:32 GMT+0800 (China Standard Time)

Publish button is set to inactive until the user checks the This document has been reviewed by a supervisor box.
After a user clicks to indicate they have had the document reviewed, the Publish button will be clickable!
Question for team: Should we set this the workflow status to in review after click and display it or for MVP?

Text needs content approval and/or wordsmithing, @thebestsophist. Currently:

Now it's clickable and you can proceed!

Not so fast! It's not that easy to publish policy live to the OMB site. You gotta be double sure.
This needs wordsmithing, too, @thebestsophist
[header] Before you publish
[subheader] You are about to publish this document to the OMB Policy Library. Before you publish, please ensure the following:
- Document has been spell-checked and edited for errors
- Document has undergone supervisor or SME approval
- Document accurately represents the original signed policy
[call to action primary] I certify – publish to library
[call to action secondary] Save without publishing
[call to action secondary] Edit
X button closes the modal and just shows you the preview page. No action taken.

Austin Hernandez · Answer 2 · Sat Feb 10 2018 06:27:20 GMT+0800 (China Standard Time)