> For the complete documentation index, see [llms.txt](https://sandgarden.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sandgarden.gitbook.io/docs/publications.md).

# Publications

Publications define which Sources Doc Holiday reads, where it writes, what kinds of content it writes, and what kinds of activity can trigger it.

#### Configuration Options

* Name - identifies this Publication inside Doc Holiday. Publication names must remain unique.
* Sources - the Sources that Doc Holiday reads for context and writes documentation into.
* Targets - the Source or Sources that Doc Holiday writes to for documentation and release notes output.
* Sharing and access - open the publication share view from the publication page to manage who can access the Publication. The publication details view also shows a People With Access area.
* Style and formatting guidance - reusable instructions from the Instruction Library that shape output for this Publication.
* Notifier connection (optional) - choose a Slack notifier to send a completion message after output is ready.
* React to - define which activity can start work for this Publication. This Publication can react to merges, releases, issues, issue comments, and workflow runs.
  * Pull Requests - creating a new pull request with `@doc.holiday` in the description starts work.
  * New Issues - creating a new issue with `@doc.holiday` in the description starts work.
  * Issue Comments - adding a comment to an existing issue with `@doc.holiday` starts work.
  * Releases - publishing a new release starts work.
  * Workflow Runs - a connected GitHub workflow run can start work when it completes.
    1. Path to workflow file - specify the workflow path to monitor, such as `/github/workflows/deploy.yml`. A workflow trigger ID can provide tighter control over automation.
    2. When the workflow completes, Doc Holiday creates the configured output.
* Output options - define what Doc Holiday should draft.
  * Release Notes - create concise summaries from the selected Sources and the triggering activity.
  * Documentation - update existing pages in place and create new documentation when the Publication calls for it.
  * Changelog - create concise changelog entries from the selected Sources and the triggering activity.
* Style Guide URL (optional, but strongly recommended) - link to a public URL or Google Drive doc for use as a style guide with this specific Publication.

See also: [Instruction Library](/docs/instruction-library.md) for shared guidance and [Work History](/docs/work-history.md) for completed work.