Work History
Overview
Work History lists publication runs as work states. Each row includes summary fields such as publication name, operation type, and status. Opening an entry shows a sheet with tabs for Details, Files, Messages, and reasoning. Work History also includes file comments, Doc Holiday’s reasoning, and notifications as standard product behavior.
Details
The Details tab shows descriptive statistics and a summary of Doc Holiday’s reasoning for the run.
Work History can show clearer status labels while work remains in progress. A staged item now appears as In Progress. If Doc Holiday’s latest bot comment asks for follow-up, Work History shows Needs Attention instead.
Open a pull request or merge request
A staged work item can be converted into an opened pull request or merge request after the run finishes. Work History does not offer Open PR or Open MR while the item is still running.
- Open a Work History entry.
- Select Open PR or Open MR.
Files
The Files tab lists the files modified during the run and shows file changes for each file.
Preview a Markdown file
Markdown files support a preview toggle that renders the full file content instead of only the file changes. Other file types continue to show the file changes view.
Download a file
- Open a Work History entry.
- Select Files.
- Select the download icon for a file.
Note: Use Download All to download a single ZIP archive that contains every file listed in the Files view for the selected work item.
Upload a file
The Files tab uses a per-file upload action.
- Open a Work History entry.
- Select Files.
- Select the upload icon for a file.
- Select a local file.
Note: Upload is disabled when a pull request or merge request URL is associated with the work item.
Exclude a file from a pull or merge request
The Files tab supports excluding specific files before opening a pull request (GitHub) or merge request (GitLab).
- Open a Work History entry.
- Select Files.
- Discard the file that is unnecessary.
To restore an excluded file, select the restore action for the file.
Excluded files are tracked on the work state and are reflected in the Files tab.
Add a file
Files can be added directly from the Files tab on a draft work item by selecting a file and specifying a destination path.
- Open a Work History entry.
- Select Files.
- Select the add file icon.
- Enter the destination file path.
- Select a local file.
Note: Upload is disabled when a pull request or merge request URL is associated with the work item.
Review file comments
The Files tab supports inline file comments during review. It lets teams add comments on specific lines or ranges, reply in anchored threads, and review quoted file context beside the affected content.
Work History keeps draft comments separate from comments already sent to Doc Holiday. Draft comments support multiline input, selected ranges can preview while drafting, and Ctrl+Enter or Cmd+Enter sends the comment.
Comment controls and visibility can vary with the conversation state and comment authorship. When the workflow allows it, the comment author can edit or delete a comment.
Work History shows comment ranges and quoted file context in clear, human readable labels. It also links file comment threads with related conversation context.
Messages
The Messages view supports continued collaboration with Doc Holiday from the Work History entry.
Some file comment threads include navigation back to related Messages context after the comment has already been sent to Doc Holiday.
When the Work History entry is running, the Messages view instructs users to wait until Doc Holiday finishes before sending more messages.
When a pull request or merge request is already open, the Messages view directs users to continue the conversation in GitHub or GitLab instead.
When the Work History entry is ready for review and not running, the send message form is available.
Notifications
When a publication has a notifier configured and the conversation reaches Ready for Review, Work History shows a Notify action. This action sends a completion update to the connected Slack channel.
Work History does not show Notify while a conversation is still running.