readthedocs / blog

Read the Docs blog
https://blog.readthedocs.com
17 stars 56 forks source link

Blog post about Telemetry database and Metabase #177

Closed humitos closed 1 year ago

humitos commented 1 year ago

Initial content for the blog post.

📚 Blog post preview 📚 : https://readthedocs-blog--177.org.readthedocs.build/knowing-more-about-ourselves/

Closes #175

humitos commented 1 year ago

@ericholscher

I went ahead and did a copy edit of the post and committed it back for ease of updating.

Thanks! I like the changes 👍🏼

I'd love to see a bit more clarity on exactly what data we're storing. Is it just Python packages & config file data?

Mainly, yes. I updated the bullet list with some more data we are storing. The code with the data structure is at https://github.com/readthedocs/readthedocs.org/blob/46365964a12c180021942c9ae8e803ae25c2f265/readthedocs/telemetry/models.py#L22

We should probably share a couple of these at least. We don't need to go overboard, but this seems like a tease without any interpretation.

OK. I will try to add a small paragraph on each of the plots to describe how we are reading them or what they are being useful for so far.

If you already have that content drafted, you should throw a PR up with it so it doesn't get lost.

No. I started writing those bullets that I've put on the description and I realized it was good content, but it would make the general reading more complex without adding too much value for most of non-technical readers.

humitos commented 1 year ago

OK. I will try to add a small paragraph on each of the plots to describe how we are reading them or what they are being useful for so far.

@ericholscher I've done this! Let me know what you think. To me, it's ready to merge and publish it.