Published on Apr 22, 2022 by Arpad Ray
A few weeks ago I deployed a pretty significant change in how our GitHub dashboards are rendered. Instead of a single SVG image to embed, we now generate templated Markdown / reST which may include smaller SVG components.
I haven't had the time to write about it until now, but I think it's worth explaining the rationale and the implications.
I'd received a fair amount of feedback (thanks!) about the dashboards. Lots of positive feedback but among the more critical, there were a few common themes:
The main hurdle in addressing these points was that we were generating a single SVG per dashboard. During the generation of this SVG we can make some guesses about what you'd like to see, but it's fundamentally a one-size-fits-all approach.
Right now the "Recent Activity" dashboard is the main beneficiary. Being composed of several components it's a great opportunity to put more power in the hands of the user. You can now select which components you'd like to have included. For example many repos don't accept issues, so that component you can ignore completely.
More generally, this change has some great benefits:
I'm continuing to work on the dashboards - both improving the output of the existing designs and also developing some new ideas - so it's worth checking back regularly to see what's new.
This change is fully backwards compatible so there's no need to do anything if you're happy with what you have now, your dashboard will continue to be updated. I think there is still merit in a single-SVG version which can be more opiniated, so that won't be going away any time soon.
Thanks to everyone who's already using our GitHub dashboards, and especially those who've taken the time to feed back on how they could be improved. It's hugely appreciated!
Whether you're tickled or irritated by something we're doing now, or you have a great idea of something else we could be doing, I'd love it hear it. Please send me an email directly at [email protected].
One click, no signup required