Skip to content

Modernize repository: fix workflows, update scripts, add docs#207

Open
amis92 wants to merge 2 commits intomainfrom
refresh/modernize-repo
Open

Modernize repository: fix workflows, update scripts, add docs#207
amis92 wants to merge 2 commits intomainfrom
refresh/modernize-repo

Conversation

@amis92
Copy link
Member

@amis92 amis92 commented Mar 16, 2026

Summary

Comprehensive repository refresh addressing broken workflows, deprecated patterns, and missing documentation.

Critical Fixes

  • update-registry.yml branch trigger was set to master but default branch is main - workflow never fired on push events
  • Removed broken gh-pages dead code from update-index.yml (referenced nonexistent workflow outputs) and deleted unused Update-GhPagesData.ps1

Workflow Modernization

  • Replaced Amadevus/pwsh-script@v2 with native run: shell: pwsh in all 3 workflows
  • Replaced Write-Action* cmdlets with native ::debug::/::warning::/::error:: workflow commands
  • Normalized all master to main references (checkout paths, comments, README)

Script Modernization

  • Updated GitHub API auth from deprecated token to Bearer prefix
  • Removed deprecated preview API header (mercy-preview+json) - topics API stable since 2020
  • Fixed DisableLastModifiedCaching param type ([string] to [switch])
  • Parameterized hardcoded BSData org name in Update-Registry.ps1
  • Removed dead FormatFileRef function (had a bug referencing $message instead of $msg)
  • Updated powershell-yaml from 0.4.2 to 0.4.7

Cleanup

  • Rewrote .gitignore - replaced 351-line VisualStudio template with 25-line minimal version
  • Updated Twitter to X URL in settings.yml

Documentation

  • Added docs/architecture.md with Mermaid data flow diagram and detailed workflow descriptions
  • Improved README.md with architecture link and repo structure overview
  • Added CONTRIBUTING.md with instructions for adding repositories
  • Added PR template and issue template for new repository requests
  • Added BsdataGallery.psd1 module manifest

Files Changed

  • 11 modified, 1 deleted, 6 created (272+ insertions, 612 deletions)

amis92 and others added 2 commits March 15, 2026 02:58
- Fix update-registry.yml branch trigger (master → main)
- Remove dead gh-pages code and Update-GhPagesData.ps1
- Replace Amadevus/pwsh-script@v2 with native pwsh run steps
- Rename checkout path master → main in update-index.yml
- Update GitHub API auth from 'token' to 'Bearer' prefix
- Remove deprecated preview API header in Validate-Registry.ps1
- Fix DisableLastModifiedCaching param type ([string] → [switch])
- Parameterize hardcoded BSData org name in Update-Registry.ps1
- Remove dead FormatFileRef function from Validate-Registry.ps1
- Replace Write-Action* calls with native workflow commands
- Update powershell-yaml from 0.4.2 to 0.4.7
- Rewrite .gitignore (351-line VS template → 25-line minimal)
- Update Twitter URL to X in settings.yml
- Improve README with architecture overview and structure
- Add CONTRIBUTING.md, PR template, issue template
- Add BsdataGallery.psd1 module manifest

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Adds docs/architecture.md covering all 4 workflows, data flow,
branches, and key files. Includes Mermaid flowchart showing the
full pipeline from repo discovery through to BattleScribe clients.
Links from README.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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