Skip to content

Sync brew.sh website theme#435

Open
MikeMcQuaid wants to merge 1 commit into
mainfrom
sync-brewsh-theme
Open

Sync brew.sh website theme#435
MikeMcQuaid wants to merge 1 commit into
mainfrom
sync-brewsh-theme

Conversation

@MikeMcQuaid
Copy link
Copy Markdown
Member

@MikeMcQuaid MikeMcQuaid commented Jun 6, 2026

Depends on Homebrew/brew.sh#1305

  • Copy shared Jekyll theme files from Homebrew/brew.sh.
  • Keep brew.sh and formulae.brew.sh rooted at the site root.
  • Sync other documentation sites into their docs directory.
  • Preserve copied file modes so bin/jekyll remains executable.
  • Expand input paths before chdir so local syncs are stable.
  • Avoid copying theme files through the existing docs sync path.

Copilot AI review requested due to automatic review settings June 6, 2026 13:38
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Syncs the shared Jekyll theme assets used across Homebrew documentation websites by sourcing the theme from Homebrew/brew.sh during the shared-config sync workflow, while keeping brew.sh and formulae.brew.sh rooted at the site root and syncing other sites under docs/.

Changes:

  • Adds an additional actions/checkout to fetch selected theme paths from Homebrew/brew.sh for use during sync.
  • Extends shared-config.rb to accept an optional brew.sh source path and copy theme directories/files into the correct site root (/ or docs/), preserving file modes.
  • Prevents theme paths from being copied via the existing Homebrew/brew docs sync path.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
.github/workflows/sync-shared-config.yml Checks out Homebrew/brew.sh (sparse) and passes it into the sync script as an additional source.
.github/actions/sync/shared-config.rb Adds optional theme sync logic from a brew.sh working copy and adjusts docs syncing to avoid duplicating theme files.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .github/workflows/sync-shared-config.yml Outdated
Comment thread .github/actions/sync/shared-config.rb
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

Comment thread .github/actions/sync/shared-config.rb Outdated
- Copy shared Jekyll theme files from `Homebrew/brew.sh`.
- Keep `brew.sh` and `formulae.brew.sh` rooted at the site root.
- Sync other documentation sites into their `docs` directory.
- Preserve copied file modes so `bin/jekyll` remains executable.
- Expand input paths before `chdir` so local syncs are stable.
- Avoid copying theme files through the existing docs sync path.
- Run sync script style checks in their own workflow job.
- Keep checkout sparse patterns compatible with cone mode.
- Prune blog assets when copying shared image files.
- Fail fast when required sync script arguments are missing.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants