Skip to content

docs: (#2075) add Template Hierarchy to Main Features section#2322

Merged
ahuseyn merged 1 commit intowpengine:canaryfrom
latenighthackathon:docs/add-template-hierarchy-feature
Apr 7, 2026
Merged

docs: (#2075) add Template Hierarchy to Main Features section#2322
ahuseyn merged 1 commit intowpengine:canaryfrom
latenighthackathon:docs/add-template-hierarchy-feature

Conversation

@latenighthackathon
Copy link
Copy Markdown
Contributor

Description

The Main Features table on the introduction page (docs/index.md) lists Authentication, Block Components, and Post Preview — but not Template Hierarchy, which is arguably the backbone of Faust.js. As the issue author noted, it's the main reason many developers use Faust and the best way for existing WordPress developers to understand the framework.

Added Template Hierarchy as the first row in the table, linking to the seed query explanation doc which covers how Faust resolves WordPress content to Next.js templates.

Related Issues

Closes #2075

Testing

Confirm the issue (before the fix)

1. Verify Template Hierarchy is missing from the features table:

grep -i "template" docs/index.md
# Expected on canary: no output

Confirm the fix

2. Verify Template Hierarchy is now listed:

grep -i "template" docs/index.md
# Expected: "Template Hierarchy" row in the features table

3. Verify the link target exists:

ls docs/explanation/seed-query/index.md
# Expected: file exists

Template Hierarchy is a core feature of Faust.js that automatically
resolves WordPress content to the correct Next.js template, mirroring
the classic PHP template hierarchy. It was missing from the Main
Features table on the introduction page despite being central to how
developers build with Faust.

Closes wpengine#2075
@latenighthackathon latenighthackathon requested a review from a team as a code owner April 3, 2026 05:58
@headless-platform-by-wp-engine
Copy link
Copy Markdown

Currently, we do not support the creation of preview deployments based on changes coming from forked repositories.
Learn more about preview environments in our documentation.

@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Apr 3, 2026

⚠️ No Changeset found

Latest commit: 776039a

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@github-project-automation github-project-automation bot moved this to 🆕 Backlog in Headless OSS Apr 3, 2026
@ahuseyn ahuseyn moved this from 🆕 Backlog to 👀 In review in Headless OSS Apr 3, 2026
@ahuseyn ahuseyn merged commit fc060c5 into wpengine:canary Apr 7, 2026
4 checks passed
@headless-platform-by-wp-engine
Copy link
Copy Markdown

Currently, we do not support the creation of preview deployments based on changes coming from forked repositories.
Learn more about preview environments in our documentation.

@github-project-automation github-project-automation bot moved this from 👀 In review to ✅ Closed in Headless OSS Apr 7, 2026
@latenighthackathon latenighthackathon deleted the docs/add-template-hierarchy-feature branch April 7, 2026 20:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: ✅ Closed

Development

Successfully merging this pull request may close these issues.

Docs - include Template Hierarchy in the "Main Features" section

2 participants