Analytics and feedback
Add privacy-friendly analytics and actionable page feedback without secret configuration.
Use Plausible for basic documentation analytics. Add one Plausible site for each canonical documentation domain.
Commit the real script ID
Use the @nuxt/scripts Plausible registry integration that Ginko Docs exposes.
Store the real Plausible script ID in the documentation app configuration. The
ID is public configuration and is not a secret environment variable.
Do not copy a raw script element into Markdown or inject the same script by two paths. The rendered page must contain exactly one correct Plausible script.
This handbook intentionally omits analytics until oss.lupinum.com has a real
Plausible site and script ID. Add it during the external launch setup. Do not
invent a placeholder ID.
Collect useful feedback
Enable the Ginko Docs “Was this page helpful?” component. A response records a
docs-feedback event when Plausible is active. The issue link opens a prefilled
documentation report in the repository.
Confirm the event in Plausible after production deployment. A visible button does not prove event delivery.
Respect privacy
Do not add fingerprinting, session replay, or user identifiers for basic docs analytics. Link the production privacy policy from every page footer.