Customer docs — open questions
Every [NEEDS CLARIFICATION: …] marker in the customer-facing documentation, with backlinks. Triage from the top — most entries are answerable by an engineer with codebase access.
Generated by scanning all customer-facing .md files at the content root. Re-run the scan command in _progress.md to refresh after writing more pages.
Getting started
| Question | Page |
|---|---|
Is there a separate “publish” action, or is every save live? Finder model has no published_at field surfaced in the digest. | getting-started/publish-and-embed.md:31 |
Features
| Question | Page |
|---|---|
| Has the Look & Feel revamp (separate ThemeSection / ShapeSection / etc.) shipped? If so, source paths shift. | features/theme-and-colors.md:38 |
Which LLM provider backs GenerateAiLocationImportJob? Customer-facing copy should mention the provider for trust/privacy. | features/ai-location-import.md:40 |
Are there per-plan row limits on AI Imports? subscription_tier middleware exists but no AI-specific gating found. | features/ai-location-import.md:41 |
| Same LLM provider as AI Import for AI Improvement? | features/ai-location-improvement.md:37 |
| Can applied AI Improvement changes be rolled back, or does undo require manual edit? | features/ai-location-improvement.md:38 |
| Are customer-supplied map API keys stored in the finder design payload (publicly visible) or proxied via the backend? | features/map-style.md:35 |
| Custom field types — resolved: text, textarea, number, select, url, email, image. Removed from tags-and-custom-fields.md 2026-05-04. | |
| Are workspace members tied to the parent account’s billing, or invoiced separately? | features/workspaces.md:39 |
Exact feature gating per tier. Code surfaces only the subscription_tier:premium check on /workspaces. | features/billing.md:35 |
| Pricing — should pricing live in docs, or only on the marketing site? | features/billing.md:36 |
| Is there a public RSS / email subscribe for the Changelog? | features/changelog.md:31 |
Customization
| Question | Page |
|---|---|
| How are fonts delivered to the embedded widget? next/font in the app, but the visitor-facing widget loads from CDN. | customization/typography.md:30 |
| Confirm widget origin-check behavior — refuse to render, render with warning, or simply not load? | customization/authorized-urls.md:31 |
Schema of advanced_refinements JSON. Need a code owner to either describe or point to a TS type. | customization/advanced-refinements.md:30 |
Embedding
| Question | Page |
|---|---|
| Is there an in-app “rotate finder key” action? If not, document the workaround. | embedding/finder-key.md:32 |
Schema of event_data JSON on Analytics model. Should be enumerable for this page. | embedding/analytics.md:32 |
| Confirm whether the embed snippet works in default WordPress without a plugin. | embedding/script-tag.md:72 |
Verify multi-finder-on-one-page rendering. Widget script reads #finder-app specifically. | embedding/script-tag.md:94 |
FAQ
| Question | Page |
|---|---|
Exact feature/tier matrix beyond /workspaces premium gating. | faq/general.md:30 |
| Confirm multi-finder semantics. | faq/general.md:58 |
| Soft-delete vs. hard-delete behavior on Location. | faq/general.md:80 |
| Is custom-font support on the roadmap? What’s the workaround? | faq/general.md:96 |
| Is there a “Powered by” attribution? If yes, what tier removes it? | faq/general.md:100 |
| Confirm member roles, invitation UX, and per-workspace member limits. | faq/general.md:112 |
| Exact IP storage policy (full IP / truncated / not stored). | faq/general.md:124 |
| Post-cancellation behavior — finders continue rendering, immediately deactivated, or read-only. | faq/general.md:138 |
| Support channels — email, in-app form, public Slack/Discord, none. | faq/general.md:144 |
Counts
- Getting started: 1
- Features: 12
- Customization: 3
- Embedding: 4
- FAQ: 9
- Total: 29 open questions
Many of these recur in multiple pages (e.g., LLM provider, multi-finder, custom field types). Answering one resolves multiple markers.