Extension talk:EventLogging/Guide

Jump to navigation Jump to search

About this board

TODO: Creating a schema should include filling out a SchemaDoc

1
Adamw (talkcontribs)

I'm leaving this breadcrumb rather than editing the page yet, pending my own self-education about meta:Template:SchemaDoc

Reply to "TODO: Creating a schema should include filling out a SchemaDoc"
Adamw (talkcontribs)

While looking for a human-readable schema, I found this text:

Schemas represent a new type of MediaWiki content, JSON schema objects, which adhere to the JSON schema specification, version 3.

I don't think this is correct. The schema defining what is a valid eventlogging schema is itself written as a full JSON-schema: https://phabricator.wikimedia.org/diffusion/EEVL/browse/master/schemas/schemaschema.json However, it restricts eventlogging schemas to something which is not JSON-schema, nor even a subset. We need to clarify this for developers, and point to the actual schema or describe it in words.

Reply to "Schema definition?"

Heads up, will be cross-referencing with BUOD DACI

3
ABaso (WMF) (talkcontribs)
Neil Shah-Quinn (WMF) (talkcontribs)

That sounds great, @ABaso (WMF)!

One thing you should consider is whether this is a general, non-Wikimedia-specific guide to the EventLogging extension or a Wikimedia-specific guide to our instrumentation infrastructure and processes. In its current form, the page seems to alternate between the two, while wikitech:Analytics/Systems/EventLogging is pretty clear about being the latter.

Clearing up that confusion could be a nice win for better use of data ;)

Tbayer (WMF) (talkcontribs)

Yeah, I was indeed mostly thinking about Wikmedia-specific (and in particular WMF Audiences specific) documentation, although I agree that mentioning it here makes sense too.

Reply to "Heads up, will be cross-referencing with BUOD DACI"

mw.eventLogging.logEvent vs mw.track

1
Gabriel Birke (WMDE) (talkcontribs)

This guide uses mw.eventLogging.logEvent instead of mw.track, like in the Programming documentation. Is there a preferred way of calling the event logging and is there a difference between the two calls? Maybe this in-depth-guide could mention that.

Reply to "mw.eventLogging.logEvent vs mw.track"
There are no older topics