Skip to content

Split FAQ into developer and community FAQs#53

Open
francismars wants to merge 4 commits into
mainfrom
feature/split-faq
Open

Split FAQ into developer and community FAQs#53
francismars wants to merge 4 commits into
mainfrom
feature/split-faq

Conversation

@francismars
Copy link
Copy Markdown

@francismars francismars commented May 28, 2026

Summary

The site had a single FAQ at /docs/faq that mixed end-user and developer topics. This PR splits that into two audiences:

  • /community/faq — User FAQ (install, safety, comparisons, features, troubleshooting, support). Primary entry: Footer → Resources → FAQ.
  • /docs/faq — Developer FAQ (publishing, signing, trust model, relay issues, growth). Studio and docs links stay on this URL.

I walked through both pages locally and the copy/UI look good to me; I would appreciate a review before merge.

What changed

  • Rewrote src/content/docs/faq.md as a developer-focused FAQ with a link to the community FAQ.
  • Added community FAQ route with accordion UI and content in src/lib/data/community-faq-content.js.
  • Added FAQ to the community sidebar; fixed scroll on the community FAQ page (data-main-scroll).
  • Footer Resources: FAQ/community/faq.
  • Sitemap includes /community/faq.
  • SEO: FAQPage JSON-LD (community-faq-seo.js), keyword-focused title/description, per-question #anchors, h3 headings, ssr = true on the FAQ page so meta and schema are in prerendered HTML.

Where the questions came from

User FAQ questions and answers were drafted from recurring Nostr threads (Zapstore account + community replies). Rewrote for clarity on the website.

Developer FAQ content aligns with existing docs (publish, trust-model) and developer-oriented items from that same research.

Review requested

  • @franzaps Please review FAQ content in general: accuracy, tone, anything misleading or missing (especially trust/safety and comparisons).
  • @NielLiesmons Please review design and frontend: community FAQ layout, accordion spacing, community shell integration, footer/nav.

Test plan

  • /community/faq — sections render, accordions open/close, page scrolls inside community shell
  • /docs/faq — developer topics only; link to community FAQ works
  • Footer User FAQ/community/faq
  • Community sidebar FAQ highlights on /community/faq
  • Cross-links: community FAQ ↔ developer FAQ; support / app page links
  • View page source (or prerendered HTML): FAQPage JSON-LD and meta tags present
  • bun run build passes

Add /community/faq with accordion UI and Nostr-derived user copy.
Refocus /docs/faq on publishing, signing, and developer support.
Link User FAQ from footer Resources; add FAQ to community nav.
Enable SSR on /community/faq so meta and schema ship in prerendered HTML.
Add per-question anchors, h3 headings, and docs canonical URLs.
@NielLiesmons
Copy link
Copy Markdown
Contributor

Going through this rn

NielLiesmons pushed a commit that referenced this pull request Jun 3, 2026
…esign

Integrate split community/developer FAQ (PR #53): /community/faq page,
developer FAQ at /docs/faq, footer and sitemap updates. Resolve community
layout conflict: keep Search (last) and FAQ nav, loadZapstoreCommunityEvent,
and distinct sidebar icons for Search vs FAQ.
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