announcements

Peter Taoussanis 2025-08-22T09:03:28.457279Z

https://www.taoensso.com/telemere v1.1.0 is out now (https://github.com/taoensso/telemere/releases/tag/v1.1.0) 🫶 > (Telemere is the successor to https://www.taoensso.com/timbre and offers a simple unified API for both structured and unstructured logging). Want to highlight one change: a big push to try and simplify onboarding. Telemere had very extensive beginner-oriented docs from day 1. But ironically the length of the docs I think ended up being overwhelming and making the lib seem more complex than it actually is. There’s a lot that Telemere can do, but you can ignore most of it. The basics are simple, and the other stuff is only relevant if/when you need it. So I’ve shifted the focus in a few ways: • I’ve excised many unnecessary mentions of advanced features. Info can still be easily found in the relevant cross-linked docstrings. • I’ve settled on recommending the more verbose but more obvious map-oriented calling API. Advanced users can continue to use the terse (positional) calling conventions if they prefer, but I’m now downplaying these in the docs. • I’ve made it clearer that 80% of Telemere’s API is actually just a single macro. Most users never need to call anything more than log!. Again, much of the other stuff is mostly sugar for advanced users that want to optimise for concision. Anyway, hopefully these changes help make the value prop clearer and the lib more approachable. Thanks to folks that have been asking questions - these help me understand where things might still be unclear! Cheers 👋

💙 3
🆒 4
🎉 21
robert-stuttaford 2025-08-22T15:39:51.173289Z

maps make the clojure world go round 😄

🫶 1
alza 2025-08-22T09:44:01.139069Z

❤️ 3
🎉 6