Roadie’s Blog

Backstage Weekly 71 - Tech Docs: default setup and zoomable images

By Jorge LainfiestaFebruary 13th, 2023

Hi y’all! This week, I’m highlighting recent contributions that will make Tech Insights easier to adopt and use. Additionally, I’m sharing the new Microsoft Calendar plugin.

Default Tech Insights settings

When you adopt Tech Docs, you’ll likely do it progressively as teams onboard their docs-as-code to their repos. To speed up this process, removing any obstacle goes a long way. For example, instead of having each team add a mkdocs.yml to their repo (and having them figure out what to put there), you could make Backstage pick up the /docs directory and integrate it into Tech Docs using default settings.

This is precisely the initiative that awanlin championed and got merged last week. You’ll be able to tell Backstage to use a basic mkdocs.yml if the file is not found in the repo. This effort is also useful when developing event-based workflows, letting you can automate the onboarding of repos without filling in all the corresponding YAML files from the beginning.

This feature will be released tomorrow as part of Backstage 1.11.0. For more details and context, check out the PR.


Using managed Backstage lets you focus on building value for your team instead of learning internals and upgrading your instance. Get a Roadie Backstage demo


TechDocs images on a LighBox

Thanks to dweber019, you’ll be able to click the images embedded in your Tech Doc pages and have them pop up in a light box, where you can even zoom in. Screenshot: lightbox on techdocs

You’ll be able to start using this feature in tomorrow’s 1.11.0 Backstage release. For more information and context, check out the PR.

New plugin: Microsoft Calendar

We’ve had a Google Calendar plugin for a while, and it was about time we had the option to connect Microsoft’s Calendar to Backstage. Thanks to Abhay-soni-developer, you can now view your upcoming events right within your Developer Portal. Screnshot: Microsoft Calendar in Backstage

You can get this plugin by installing @backstage/plugin-microsoft-calendar in your instance and adding the corresponding card to your homepage. For additional context, check out the PR.


Talk to you next week!

Jorge L

Become a Backstage expert

To get the latest news, deep dives into Backstage features, and a roundup of recent open-source action, sign up for Roadie's Backstage Weekly. See recent editions.

We will never sell or share your email address.