Add telemetry chapter to the docs

[DimedS]

Description

This PR adds a summary of telemetry information to the Kedro documentation, into the plugins section. It includes a link to the README.md file in the kedro-telemetry repository for detailed information.

Developer Certificate of Origin

We need all contributions to comply with the Developer Certificate of Origin (DCO). All commits must be signed off by including a Signed-off-by line in the commit message. See our wiki for guidance.

If your PR is blocked due to unsigned commits, then you must follow the instructions under "Rebase the branch" on the GitHub Checks page for your PR. This will retroactively add the sign-off to all unsigned commits and allow the DCO check to pass.

Checklist

• Read the contributing guidelines
• Signed off each commit with a Developer Certificate of Origin (DCO)
• Opened this PR as a 'Draft Pull Request' if it is work-in-progress
• Updated the documentation to reflect the code changes
• Added a description of this change in the RELEASE.md file
• Added tests to cover my changes
• Checked if this change will affect Kedro-Viz, and if so, communicated that with the Viz team

[stichbury]

I'm guessing we have to use this as legal boilerplate. I am reviewing it as such so not requesting US spelling converted to English here. I think you should probably call it kedro-telemetry rather than Kedro-Telemetry.

Approving because I suspect there's limited wriggle room for changes.

[astrojuanlu]

I left a comment about one bit in the text I don't understand which was present in the original one.

Aside from that, I like the text but not where it's placed, inside the "how to extend Kedro" section. I think it's difficult to find, and unrelated to the rest of the content.

Should we add a top-level section that is titled "Privacy policy" or "Telemetry collection" instead, so it's more visible? Maybe under "Learn about Kedro". Similar to other projects kedro-org/kedro-plugins#510 (comment) (see "Documentation" column).

wdyt @stichbury ?

[stichbury]

Should we add a top-level section that is titled "Privacy policy" or "Telemetry collection" instead, so it's more visible? Maybe under "Learn about Kedro". Similar to other projects kedro-org/kedro-plugins#510 (comment) (see "Documentation" column).

wdyt @stichbury ?

I think the placement is OK TBH, since it's covering the telemetry plugin details and the plugin is, in itself, an example of a plugin. I also think moving it to a distinct section is adding the expense of accidental complexity to most readers (who don't care about it) at the benefit of the few who do. I'd personally leave it and signpost it (if we don't already) from where those concerned readers are most likely to be looking (as you suggest, the privacy policy).

Just my 2p though.

[astrojuanlu]

I'm still not convinced to be honest. That page is about how to extend Kedro through plugins, and contains lots of technical documentation that I'd expect to be there. Adding kedro-telemetry there feels weird - for consistency, we should be adding there a description of all our plugins, which I think it wouldn't make sense and also would obscure the location of the data collection information even more.

I'll come up with a proposal and push directly to this branch.