Skip to content

Docs miss some script version 12 changes #68

Open

Description

@simpleanalytics-agent

What

Script version 12 (simpleanalytics/scripts#40) is live, and #62 documents most of it. Some v12 changes are still missing or outdated in the docs:

  • The data-referrer / sa_settings.referrer setting isn't documented.
  • sa_pageview docs don't cover the callback, a query string in the path, the custom namespace (ba_pageview), or that the function is always available.
  • The events introduction still says sa_pageview keeps its name with a custom namespace, and that inline events need a helper script.
  • The metadata page says sa_metadata is only read once, when the script loads.
  • The allow params page says parameter names are case-sensitive.
  • The CSP page says automated events need 'unsafe-inline' for onclick attributes.
  • The metrics, what we collect, and URL parameter pages don't mention query parameter names or the script URL being sent.
  • There's no "what's new" page for v12, like the ones for v9 and v10.

Why

Customers on v12 get wrong or incomplete information about what the script does and collects.

Notes

Follows #61.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions