Skip to content

Keep PSWriteOffice website docs current from its default branch - #2374

Merged
PrzemyslawKlys merged 3 commits into
masterfrom
fix/pswriteoffice-source-ingestion
Aug 19, 2026
Merged

PrzemyslawKlys merged 3 commits into
masterfrom
fix/pswriteoffice-source-ingestion

Conversation

@PrzemyslawKlys

@PrzemyslawKlys PrzemyslawKlys commented Aug 19, 2026

Copy link
Copy Markdown
Member

Summary

  • refresh PSWriteOffice documentation from the repository default branch during an ordinary OfficeIMO website build
  • remove the stale commit lock and clean the source checkout before synchronization
  • keep an explicitly selected PSWriteOfficeRoot authoritative for local branch and PR previews
  • fail immediately when an explicit source is missing or is not a PSWriteOffice repository
  • derive documentation counts from the ingested catalog instead of a hard-coded total
  • protect the default-source and manifest behavior with website contract checks

Default and preview behavior

  • Normal build: clone EvotecIT/PSWriteOffice cleanly from its remote default branch and record the resolved source manifest.
  • Preview build: pass -PSWriteOfficeRoot <path> or set PSWRITEOFFICE_ROOT; that checkout supplies the documentation, recipes, command metadata, and generated pages.

This lets the public site advance automatically after PSWriteOffice changes reach its default branch while still allowing an open branch or local checkout to be previewed as one consistent revision.

Shared build invariant

Companion PowerForge PR EvotecIT/PSPublishModule#783 prevents sources-sync from being skipped by the general pipeline cache. Without that owner-level fix, repeated local builds could reuse an older source checkout even though the OfficeIMO source is configured to follow the default branch.

Validation

  • post-merge default ingestion resolved the current PSWriteOffice remote HEAD (main) and passed the documentation pipeline with 123 conceptual pages
  • explicit PR-checkout ingestion passed the same contracts with 123 conceptual pages
  • two consecutive cache-enabled source runs executed synchronization and resolved the current remote commit
  • an invalid explicit source failed before documentation synchronization

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

@PrzemyslawKlys PrzemyslawKlys changed the title Honor explicit PSWriteOffice documentation sources Keep PSWriteOffice website docs current from its default branch Aug 19, 2026
@PrzemyslawKlys
PrzemyslawKlys merged commit 0179dff into master Aug 19, 2026
5 checks passed
@PrzemyslawKlys
PrzemyslawKlys deleted the fix/pswriteoffice-source-ingestion branch August 19, 2026 10:01
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.

1 participant