While working on the parent task, Faidon raised some questions related to ES documentation:
- Description of parameters in https://stream.wikimedia.org/?doc#/Streams/get_v2_stream_recentchange (and all the others) seems broken, there are errors in the JS console:
root-injects.jsx:95 TypeError: Cannot read property 'get' of undefined at t.value (parameter-row.jsx:175) at t.render (root-injects.jsx:93) at s._renderValidatedComponentWithoutOwnerOrContext (ReactCompositeComponent.js:796)
- The response format (https://wikitech.wikimedia.org/wiki/Event_Platform/EventStreams#Response_Format) is not super clear, there are discrepancies between eqiad and codfw for recent changes:
id: [{"topic":"eqiad.mediawiki.revision-create","partition":0,"timestamp":1573182905001},{"offset":57092325,"partition":0,"topic":"codfw.mediawiki.revision-create"}]
Why for eqiad we have a timestamp and for codfw an offset? This should be documented somewhere.
- In https://wikitech.wikimedia.org/wiki/Event_Platform/EventStreams#Response_Format it is not super clear what a URL for recent changes should look like if somebody wants to resume consumption from a certain offset.