Workflow: Questions and Tasks

Workflow: Questions and Tasks

Follow this workflow to answer questions about and do work on site content. You might be able to skip some of the questions based on the nature of the content and scope of change, but all of them are worth a run-through!

Plan → Create → Revise → Approve → Test → Publish

PLAN

Questions to ask:

1. Does this content already exist, and in what format?
2. How does adding/changing this content solve a problem for the users?
3. How does adding/changing this content fit in with OIRA/OMB goals?
4. Is pra.digital.gov the best place for this content to live?
5. Does this connect to other content? Some places to check with:

• OMB Comms & OGC
• Digital.gov team
• WH Digital Strategy

Work:

1. Create GitHub issue to track conversation around the content.
2. Conduct research/review to further define the problem. Interview users and subject matter experts.

CREATE

Questions to ask:

1. How does this content fit into the information architecture (IA, or organization/navigation) of the site?
2. What can the user do with the content?

Work:

1. Review the IA and determine where the content will go.
2. Outline the content based on the call to action/user outcome.
3. Write in plain language, using short sentences and frequent headers to improve readability

REVISE

Questions to ask:

1. Who can edit this for subject matter accuracy and clarity?
2. Who can edit this for plain language, usable structure, and accessibility?
3. Who can edit this for legal accuracy?

Work:

1. Set revision schedule, including deadline.
2. Track revision history and dates in GitHub issue.
3. Put final content into GitHub.

APPROVE

Questions to ask:

1. Who approves this content to go into production (GitHub)
2. Who needs to be informed that it’s moving forward?

Work:

1. Determine content approver.
2. Set approval timeline and deadlines.
3. Assign GitHub pull request to OIRA approver and digital.gov staff

TEST

Questions to ask:

1. Does this content solve the user’s problem?
2. Are new issues present now that this content is part of pra.digital.gov

Work:

1. Usability testing appropriate to the content.
2. Document issues in GitHub, including creating new ones for observed issues or questions.

• Assign GitHub issues after they’re entered.

PUBLISH

Questions to ask:

1. Who will work with the digital.gov team for publication?
2. Do other groups need to know about publication, or does it need to sync to other content?

Work:

1. Close OIRA workflow and tag digital.gov team for squash and merge.
2. Follow up with groups outside of OIRA as necessary, including:

• OMB Comms & OGC
• Digital.gov team
• WH Digital Strategy