Skip to content

Static Files Migration#445

Open
Ethan-Arrowood wants to merge 4 commits intomajor-version-reorgfrom
migration/static-files
Open

Static Files Migration#445
Ethan-Arrowood wants to merge 4 commits intomajor-version-reorgfrom
migration/static-files

Conversation

@Ethan-Arrowood
Copy link
Member

Summary

  • Migrates the static built-in plugin documentation into the v4 consolidated reference structure
  • Covers basic usage, files/urlPath options, v4.7 plugin options, auto-update behavior, and practical examples
  • Drops the planned configuration.md — all static plugin configuration is inline to the plugin itself (no Harper-level config exists for static files)

Files Created

  • reference_versioned_docs/version-v4/static-files/overview.md
  • migration-context/link-placeholders/static-files-link-placeholders.md

Files Modified

  • reference_versioned_sidebars/version-v4-sidebars.json — Static Files category added
  • v4-docs-migration-map.md — status updated to In Progress, source notes and release note references added

Source Files Used

reference_versioned_docs/version-v4/static-files/overview.md

  • versioned_docs/version-4.7/reference/components/built-in-extensions.md — primary (static section)
  • versioned_docs/version-4.6/reference/components/built-in-extensions.md — pre-v4.7 behavior comparison
  • versioned_docs/version-4.5/developers/components/built-in.md — early v4 behavior
  • release_notes/v4-tucker/4.7.2.mdindex.html default behavior
  • release_notes/v4-tucker/4.7.3.md — trailing slash fix

Version Annotations Added

High Confidence (confirmed via version comparison)

  • static plugin present since at least v4.4 (present in v4.4 and v4.5 docs)
  • extensions, fallthrough, index, notFound options, and auto-update behavior: added in v4.7.0 (not present in v4.6 docs, present in v4.7 docs)

Noted in migration map

  • static may predate v4.4 — earliest versioned docs available are v4.4; exact introduction version unconfirmed

Link Placeholders Created

See migration-context/link-placeholders/static-files-link-placeholders.md for complete list.

Summary: 3 placeholders, all pointing to the future Components Overview page (reference_versioned_docs/version-v4/components/overview.md)

Checklist for Human Reviewer

  • Verify version annotations (v4.7.0 for Plugin API options inferred from version comparison)
  • Confirm static plugin introduction version (pre-v4.4 history not available in versioned docs)
  • Review content accuracy and completeness
  • Update migration-map.md status to "Complete" after merge

🤖 Generated with Claude Code

@Ethan-Arrowood Ethan-Arrowood requested a review from a team as a code owner February 24, 2026 21:18
@Ethan-Arrowood Ethan-Arrowood changed the title docs: migrate Static Files section to v4 consolidated reference Static Files Migration Feb 24, 2026
Ethan-Arrowood and others added 2 commits February 24, 2026 14:29
- Add reference_versioned_docs/version-v4/static-files/overview.md
  covering the static built-in plugin: basic usage, files/urlPath,
  v4.7 options (index, extensions, fallthrough, notFound), auto-update
  behavior, and examples including SPA client-side routing pattern
- Add Static Files category to version-v4 sidebar
- Add migration-context/link-placeholders/static-files-link-placeholders.md
- Update v4-docs-migration-map.md status to In Progress with source notes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions
Copy link

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-docs.stage.harperfabric.com/pr-445

This preview will update automatically when you push new commits.

@github-actions github-actions bot temporarily deployed to pr-445 February 24, 2026 21:31 Inactive
GET /blog/post-1 -> static/blog/post-1.html
```

### Custom 404 page
Copy link
Contributor

Choose a reason for hiding this comment

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

Do we have a support for a custom 500 page?

Copy link
Member Author

Choose a reason for hiding this comment

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

Copy link
Contributor

@cb1kenobi cb1kenobi left a comment

Choose a reason for hiding this comment

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

LGTM

@github-actions github-actions bot temporarily deployed to pr-445 February 25, 2026 15:25 Inactive
@github-actions
Copy link

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-docs.stage.harperfabric.com/pr-445

This preview will update automatically when you push new commits.

@github-actions
Copy link

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-docs.stage.harperfabric.com/pr-445

This preview will update automatically when you push new commits.

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