Skip to main content

How to Publish a Specification

How to complete an approval workflow and then publish the final specification, once every reviewer has finished.

Before publishing, make sure you've worked through the feedback from every reviewer. See How to Review Feedback on a Specification if you haven't already.

Publishing includes two separate steps: completing the approval workflow, and then publishing the specification itself.

Step 1: Completing the Workflow

Once every reviewer in every stage has completed their review, a banner appears on the Workflow tab letting you know it's your turn to finish things up.

  1. Go to the Workflow tab.

  2. Click Complete approval workflow in the banner.

  3. Confirm by clicking Yes, complete approval workflow in the dialog that appears.

Once confirmed, the Workflow tab shows when the workflow finished and how long it took. At this point:

  • The specification is still in In Review status, not yet published.

  • All comments and suggestions are still there, untouched.

Step 2: Publishing the Specification

Once the workflow is complete, a Publish spec button appears at the top of the page, next to Revert to draft.

Before you click it, double check a few things, since anything left unresolved won't carry forward:

  • Review pending suggestions. Filter the Comments panel to Open. Any suggestion you haven't accepted or rejected by the time you publish will simply disappear — it isn't saved or recoverable afterward.

  • Review unresolved comments. You don't have to resolve every comment, but read through anything still open.

  • Read through the full specification one more time to confirm you're happy with the final version.

When you're ready, click Publish spec.

What Publishing Does (and Doesn't Do)

Once published, this becomes the official version of the specification inside Holly. The Published spec tab always reflects whichever version is currently live.

Warning: Publishing a specification in Holly does not update any version of it that's public elsewhere — for example, on your agency's public job listings page or external website. Holly doesn't sync or export to any external system automatically. If that specification also needs to be updated somewhere outside Holly, that update is entirely manual and separate from anything in Holly.

To see how a newly published version relates to previous ones, see Working with the History Tab.

Did this answer your question?