> 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/getting-started.md).

# Getting Started

This guide covers the first setup path for Doc Holiday.

### 1. Install Doc Holiday

GitHub, GitLab, and Bitbucket are supported. Install the provider for GitHub, GitLab, or Bitbucket, then add the repository as a Source in Doc Holiday.

### 2. Add Sources

* Add each Source that Doc Holiday should read from when it writes documentation or release notes. If code and documentation live in the same repository, then one Source is enough.

### 3. Create a Publication

* Add at least one Publication to define which Sources Doc Holiday reads from and which repository it writes to.
* For each Publication, configure:
  * Name: Internal reference for the Publication
  * Source(s): Sources containing relevant source material
  * Target(s): The repository for documentation and release notes output
  * Style guidance: Link to the [Instruction Library](/docs/instruction-library.md) for shared guidance
  * React To: Choose the activity that should trigger Doc Holiday, such as Pull Requests, Issues, Issue Comments, Releases, or Workflow Runs
  * Write: Choose the output to generate, either documentation, release notes, or changelog.
* See [Publications](/docs/publications.md) for the full configuration reference.

### 4. Start writing

Doc Holiday can now generate and update documentation and release notes from the triggers configured in each Publication. To interact directly, mention `@doc.holiday` in issues, pull requests, or release events, and Doc Holiday will respond with the next step. Completed work appears in [Work History](/docs/work-history.md).
