metrics icon indicating copy to clipboard operation
metrics copied to clipboard

Learning material

Open LukeMathWalker opened this issue 1 year ago • 4 comments

With my employer, we developed a workshop to teach folks the ropes about telemetry for Rust applications.
It's entirely self-paced: it's a collection of exercises with tests to validate your solutions. It covers the metrics crate in quite some detail in the 03_metrics section.

All exercises are available on GitHub and the material is CC BY-NC 4.0 DEED licensed.

Is this something you might be interested in linking to from the README or the documentation, in the same vein of the External resources section in tracing's repo?

LukeMathWalker avatar Dec 07 '23 13:12 LukeMathWalker

Hey there, this is nice. :)

I'd definitely be in favor of linking to it in the README. One thing that might add a little bit of complexity, though, is that as soon as we cut the next release of metrics, where things switch to counter!("foo").increment(1), and so on, the guide will potentially be out-of-date? I haven't read through all of it, though, so maybe it doesn't as heavily depend on existing code examples?

tobz avatar Dec 10 '23 12:12 tobz

It'll be out of date for a bit, but we're going to update it to the latest version shortly after it comes out 👍🏻

LukeMathWalker avatar Dec 10 '23 14:12 LukeMathWalker

Just a heads up that I'll be cutting new releases soon with all the big, recent changes. I'll ping you here once that happens so you can update your stuff, and then once it's all lined up, we can start referencing it in the README.

tobz avatar Dec 23 '23 14:12 tobz

@LukeMathWalker A belated response here, but, we've cut the new releases for metrics as of a few weeks ago. I'm not sure if your learning material is up-to-date with the latest changes yet, but we're probably good now to resume talking about getting that linked up in this repository.

tobz avatar Feb 03 '24 15:02 tobz

Thanks for the ping @tobz! The workshop has been updated to the latest version of metrics.

LukeMathWalker avatar Feb 29 '24 16:02 LukeMathWalker

Alright, I added a link to the workshop on the main README in 54939fa.

Let me know if that looks good/bad to you.

tobz avatar Mar 16 '24 14:03 tobz

I think linking to the repository's homepage would be better, otherwise it's unclear how to actually progress through the workshop/what needs to be installed/etc.

LukeMathWalker avatar Mar 16 '24 15:03 LukeMathWalker

Fair enough, yeah. Linked to the repository root. 👍🏻

tobz avatar Mar 16 '24 15:03 tobz