Skip to content

Move Support Articles guidance under Storefront - #19

Merged
next-devin merged 2 commits into
mainfrom
support-articles-location
Jul 31, 2026
Merged

Move Support Articles guidance under Storefront#19
next-devin merged 2 commits into
mainfrom
support-articles-location

Conversation

@next-devin

Copy link
Copy Markdown
Contributor

Summary

  • Retitle the storefront page to Support Articles
  • Point Articles and Categories to Storefront > Articles and the direct dashboard route
  • Update the Storefront overview and link the Support Guide to the new location

Validation

  • npm run audit-developer-links
  • npm run validate-links
  • npm run build (268 static pages)
  • git diff --check

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 31, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
nextcommerce-docs df5d726 Commit Preview URL

Branch Preview URL
Jul 31 2026, 04:36 AM

@next-devin
next-devin marked this pull request as ready for review July 31, 2026 04:27
Navigate to **Support > Categories** to set up Support Categories. Categories can be set to Public (visible on your storefront to all customers) or non-Public, which will only be available to users with Dashboard permissions. Set the Display Order to determine in which order the categories will appear on the storefront, and choose to Feature certain categories in your storefront's help section.
Navigate to **Storefront > Articles**, or go directly to `https://<store>.29next.store/dashboard/theme/articles/`, to manage Support Articles and Categories.

From the **Articles** tab you can view, create, and modify Support Articles, and assign them to Support Categories. Articles can be set to Public (visible on your storefront to all customers) or non-Public, which will only be viewable by users with Dashboard permissions -- this is useful for building an internal knowledge base for your staff that isn't visible to customers.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

SUGGESTION: Verify "tab" terminology matches the dashboard UI.

The previous wording referred to "Support > Articles menu". The new wording calls Articles and Categories "tabs" within the Storefront > Articles dashboard view. If the in-dashboard page actually shows Articles and Categories as top-level nav items or sections (not literal tabs), readers following these instructions may not be able to locate them. Worth a quick confirmation against the live dashboard.


Reply with @kilocode-bot fix it to have Kilo Code address this issue.


From the **Articles** tab you can view, create, and modify Support Articles, and assign them to Support Categories. Articles can be set to Public (visible on your storefront to all customers) or non-Public, which will only be viewable by users with Dashboard permissions -- this is useful for building an internal knowledge base for your staff that isn't visible to customers.

From the **Categories** tab, you can create and manage Support Categories. Categories can be set to Public (visible on your storefront to all customers) or non-Public, which will only be available to users with Dashboard permissions. Set the Display Order to determine in which order the categories will appear on the storefront, and choose to Feature certain categories in your storefront's help section.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

SUGGESTION: Same "tab" terminology concern as the Articles paragraph above - confirm against the dashboard UI.


Reply with @kilocode-bot fix it to have Kilo Code address this issue.


From the **Support > Articles** menu you can view, create, and modify new Support Articles, and assign them to Support Categories. Articles can be set to Public (visible on your storefront to all customers) or non-Public, which will only be viewable by users with Dashboard permissions -- this is useful for building an internal knowledge base for your staff that isn't visible to customers.

Set the Display Order to determine in which order the articles will appear within their respective storefront categories.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

WARNING: This sentence is now orphaned after the surrounding paragraph was removed in this PR.

Previously this "Display Order..." line was preceded by the "From the Support > Articles menu you can view, create, and modify new Support Articles..." paragraph, which provided the Articles context. That intro paragraph was deleted by this PR (its content is now folded into the new Articles paragraph at line 11) but the Display Order sentence was left dangling here as a bare sentence. Either move it into the new Articles paragraph at line 11, or rephrase to make its referent clear (e.g. "For Articles, also set the Display Order...").


Reply with @kilocode-bot fix it to have Kilo Code address this issue.

<Card title="SEO" description="Configure meta tags, social sharing, and search appearance across your store" href="/docs/build-a-store/storefront/seo" />
<Card title="Customer Accounts" description="Self-service portal for orders, subscriptions, and support" href="/docs/build-a-store/storefront/customer-accounts" />
<Card title="Support Content" description="Build FAQ and knowledge base articles for customer self-service" href="/docs/build-a-store/storefront/support-content" />
<Card title="Support Articles" description="Build FAQ and knowledge base articles for customer self-service" href="/docs/build-a-store/storefront/support-content" />

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

SUGGESTION: Card title and the underlying page slug no longer match.

The Card title was renamed to "Support Articles" but the href still points to /docs/build-a-store/storefront/support-content, and the underlying file is support-content.mdx. Users navigating by title ("Support Articles") won't see a matching URL slug. If backward compatibility/redirects matter, leave a redirect in place when renaming the file to support-articles.mdx; otherwise keep the slug stable and document the rename in the release notes so the SEO/permalink drift is intentional.


Reply with @kilocode-bot fix it to have Kilo Code address this issue.

@kilo-code-bot

kilo-code-bot Bot commented Jul 31, 2026

Copy link
Copy Markdown

Code Review Summary

Status: 3 Issues Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 0
SUGGESTION 3
Issue Details (click to expand)

SUGGESTION

File Line Issue
content/docs/build-a-store/storefront/support-content.mdx 11 Verify "tab" terminology matches the actual dashboard UI for Articles.
content/docs/build-a-store/storefront/support-content.mdx 13 Verify "tab" terminology matches the actual dashboard UI for Categories.
content/docs/build-a-store/storefront/index.mdx 14 Card title "Support Articles" no longer matches the underlying page slug /storefront/support-content.
Files Reviewed (3 files)
  • content/docs/build-a-store/storefront/index.mdx - 1 issue
  • content/docs/build-a-store/storefront/support-content.mdx - 2 issues
  • content/docs/manage/support.mdx - 0 issues

Fix these issues in Kilo Cloud

Previous Review Summary (commit 19e1671)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit 19e1671)

Status: 4 Issues Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 3
Issue Details (click to expand)

WARNING

File Line Issue
content/docs/build-a-store/storefront/support-content.mdx 21 The "Set the Display Order..." sentence is orphaned after its preceding paragraph was deleted by this PR.

SUGGESTION

File Line Issue
content/docs/build-a-store/storefront/support-content.mdx 11 Verify "tab" terminology matches the actual dashboard UI for Articles.
content/docs/build-a-store/storefront/support-content.mdx 13 Verify "tab" terminology matches the actual dashboard UI for Categories.
content/docs/build-a-store/storefront/index.mdx 14 Card title "Support Articles" no longer matches the underlying page slug /storefront/support-content.
Files Reviewed (3 files)
  • content/docs/build-a-store/storefront/index.mdx - 1 issue
  • content/docs/build-a-store/storefront/support-content.mdx - 3 issues
  • content/docs/manage/support.mdx - 0 issues

Fix these issues in Kilo Cloud


Reviewed by minimax-m3 · Input: 44.9K · Output: 1.5K · Cached: 120.1K

@next-devin
next-devin merged commit a1576a1 into main Jul 31, 2026
2 of 3 checks passed
@next-devin
next-devin deleted the support-articles-location branch July 31, 2026 09:07
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