From 2a2091387747ae6c4ce5159414c956f6b10b4f4c Mon Sep 17 00:00:00 2001 From: blam Date: Thu, 27 Apr 2023 21:23:57 +0200 Subject: [PATCH] chore: use the new syntax for truncate Signed-off-by: blam --- microsite/blog/2020-03-16-announcing-backstage.md | 3 ++- microsite/blog/2020-03-18-what-is-backstage.md | 3 ++- microsite/blog/2020-04-06-lighthouse-plugin.md | 3 ++- .../blog/2020-04-30-how-to-quickly-set-up-backstage.md | 3 ++- microsite/blog/2020-05-14-tech-radar-plugin.md | 3 ++- ...2020-05-14-weaveworks-covid-19-app-uses-backstage-ui.md | 3 ++- microsite/blog/2020-05-22-phase-2-service-catalog.md | 3 ++- .../blog/2020-06-22-backstage-service-catalog-alpha.md | 3 ++- ...to-enable-authentication-in-backstage-using-passport.md | 3 ++- .../2020-08-05-announcing-backstage-software-templates.md | 3 ++- microsite/blog/2020-09-08-announcing-tech-docs.md | 3 ++- microsite/blog/2020-09-23-backstage-cncf-sandbox.md | 3 ++- microsite/blog/2020-09-30-backstage-design-system.md | 3 ++- microsite/blog/2020-09-30-plugin-marketplace.md | 3 ++- microsite/blog/2020-10-22-cost-insights-plugin.md | 3 ++- microsite/blog/2020-12-22-stability-index.md | 3 ++- ...-new-backstage-feature-kubernetes-for-service-owners.md | 3 ++- microsite/blog/2021-05-20-adopting-backstage.md | 3 ++- microsite/blog/2021-06-22-spotify-backstage-is-growing.md | 3 ++- .../2021-06-24-announcing-backstage-search-platform.md | 3 ++- .../blog/2021-07-26-software-templates-are-now-in-beta.md | 3 ++- microsite/blog/2021-09-16-the-techdocs-beta-has-landed.md | 3 ++- microsite/blog/2021-09-30-50-public-adopters.md | 3 ++- microsite/blog/2021-12-20-backstage-wrapped-2021.md | 3 ++- microsite/blog/2022-01-25-backstage-homepage-templates.md | 3 ++- microsite/blog/2022-03-04-backstage-upgrade-helper.md | 3 ++- microsite/blog/2022-03-16-backstage-turns-two.md | 3 ++- microsite/blog/2022-03-17-backstage-1.0.md | 3 ++- microsite/blog/2022-05-13-techdocs-addon-framework.md | 3 ++- .../blog/2022-07-19-releasing-backstage-search-1.0.md | 3 ++- microsite/blog/2022-08-23-backstage-security-audit.md | 3 ++- microsite/blog/2022-09-08-fyi-plugin-analytics-api.md | 3 ++- ...15-linux-foundation-introduction-to-backstage-course.md | 3 ++- microsite/blog/2022-12-19-backstage-wrapped-2022.md | 3 ++- microsite/blog/2023-01-31-incremental-entity-provider.md | 3 ++- microsite/blog/2023-02-06-whats-ahead-in-2023.md | 3 ++- microsite/blog/2023-02-15-backend-system-alpha.md | 3 ++- microsite/blog/2023-03-15-backstage-turns-3.md | 3 ++- microsite/docusaurus.config.js | 7 ++----- 39 files changed, 78 insertions(+), 43 deletions(-) diff --git a/microsite/blog/2020-03-16-announcing-backstage.md b/microsite/blog/2020-03-16-announcing-backstage.md index 5094de7b37..b76ee6bffa 100644 --- a/microsite/blog/2020-03-16-announcing-backstage.md +++ b/microsite/blog/2020-03-16-announcing-backstage.md @@ -13,7 +13,8 @@ It’s the first open source infrastructure platform by Spotify that allows you ![img](assets/blog_1.png) - + +{/* truncate */} ## As simple as writing a plugin. diff --git a/microsite/blog/2020-03-18-what-is-backstage.md b/microsite/blog/2020-03-18-what-is-backstage.md index 5e3ec4ac90..0024033c66 100644 --- a/microsite/blog/2020-03-18-what-is-backstage.md +++ b/microsite/blog/2020-03-18-what-is-backstage.md @@ -9,7 +9,8 @@ authorImageURL: https://pbs.twimg.com/profile_images/121166861/6919c047c0d0edaac Two days ago, we released the open source version of [Backstage](https://backstage.io/), our homegrown developer portal. And we learned a thing or two via the feedback we received. So, I wanted to take this opportunity to further explain what we’re trying to do with Backstage — and more importantly, what we want to give to the greater engineering community beyond Spotify. - + +{/* truncate */} ## What’s the big infrastructure problem? diff --git a/microsite/blog/2020-04-06-lighthouse-plugin.md b/microsite/blog/2020-04-06-lighthouse-plugin.md index dcdb4b78e5..f0957c99ff 100644 --- a/microsite/blog/2020-04-06-lighthouse-plugin.md +++ b/microsite/blog/2020-04-06-lighthouse-plugin.md @@ -9,7 +9,8 @@ authorImageURL: https://pbs.twimg.com/profile_images/1224058798958088192/JPxS8uz We’re proud to announce that our first internal plugin at Spotify has been open-sourced as part of Backstage. This plugin works with the newly open-sourced [lighthouse-audit-service](https://github.com/spotify/lighthouse-audit-service) to run and track Lighthouse audits for your websites. - + +{/* truncate */} ## What is Lighthouse? diff --git a/microsite/blog/2020-04-30-how-to-quickly-set-up-backstage.md b/microsite/blog/2020-04-30-how-to-quickly-set-up-backstage.md index 7d5098a721..bbcebd9641 100644 --- a/microsite/blog/2020-04-30-how-to-quickly-set-up-backstage.md +++ b/microsite/blog/2020-04-30-how-to-quickly-set-up-backstage.md @@ -11,7 +11,8 @@ We want users to be able to create their own version of Backstage quickly and ea In this blog post we’ll look at what a Backstage app is and how to create one using our [CLI](https://www.npmjs.com/package/@backstage/cli). - + +{/* truncate */} ## What is a Backstage app? diff --git a/microsite/blog/2020-05-14-tech-radar-plugin.md b/microsite/blog/2020-05-14-tech-radar-plugin.md index b78cf9004f..4f58b55c60 100644 --- a/microsite/blog/2020-05-14-tech-radar-plugin.md +++ b/microsite/blog/2020-05-14-tech-radar-plugin.md @@ -9,7 +9,8 @@ authorImageURL: https://avatars0.githubusercontent.com/bih Just a few weeks ago, we released our internal plugin for [Lighthouse website audits] as our first open source plugin, so the whole community could use it. Today, we’re excited to add a new plugin to that list — say hello to the [Tech Radar plugin]! - + +{/* truncate */} ## What is Tech Radar? diff --git a/microsite/blog/2020-05-14-weaveworks-covid-19-app-uses-backstage-ui.md b/microsite/blog/2020-05-14-weaveworks-covid-19-app-uses-backstage-ui.md index 3e3d8a537a..06f98f5474 100644 --- a/microsite/blog/2020-05-14-weaveworks-covid-19-app-uses-backstage-ui.md +++ b/microsite/blog/2020-05-14-weaveworks-covid-19-app-uses-backstage-ui.md @@ -9,7 +9,8 @@ authorImageURL: https://avatars2.githubusercontent.com/u/46946747 One of the great things about the open source community is once you put your work out there, you really never know where it might end up. That’s certainly the case here. - + +{/* truncate */} When Weaveworks decided to build an X-ray diagnostics app to help fight COVID-19, they pulled together a lot of different open source resources — from projects big and small, built by both familiar tech partners and some brand new ones, too. diff --git a/microsite/blog/2020-05-22-phase-2-service-catalog.md b/microsite/blog/2020-05-22-phase-2-service-catalog.md index 5ab994a343..e3a5b5eb8a 100644 --- a/microsite/blog/2020-05-22-phase-2-service-catalog.md +++ b/microsite/blog/2020-05-22-phase-2-service-catalog.md @@ -12,7 +12,8 @@ We released the open source version of Backstage a little less than two months a ![img](assets/20-05-20/Service_Catalog_MVP.png) - + +{/* truncate */} ## Progress so far diff --git a/microsite/blog/2020-06-22-backstage-service-catalog-alpha.md b/microsite/blog/2020-06-22-backstage-service-catalog-alpha.md index 0f324cd5be..6e79de726b 100644 --- a/microsite/blog/2020-06-22-backstage-service-catalog-alpha.md +++ b/microsite/blog/2020-06-22-backstage-service-catalog-alpha.md @@ -9,7 +9,8 @@ image: https://backstage.io/blog/assets/6/header.png ![img](assets/6/header.png) - + +{/* truncate */} ## You asked, we listened diff --git a/microsite/blog/2020-07-01-how-to-enable-authentication-in-backstage-using-passport.md b/microsite/blog/2020-07-01-how-to-enable-authentication-in-backstage-using-passport.md index ce778c9dc2..961609f569 100644 --- a/microsite/blog/2020-07-01-how-to-enable-authentication-in-backstage-using-passport.md +++ b/microsite/blog/2020-07-01-how-to-enable-authentication-in-backstage-using-passport.md @@ -9,7 +9,8 @@ authorImageURL: https://avatars1.githubusercontent.com/u/1236238?s=460&v=4 Getting authentication right is important. It helps keep your platform safe, it’s one of the first things users will interact with, and there are many different authentication providers to support. To this end, we chose to use [Passport](http://www.passportjs.org/) to provide an easy-to-use, out-of-the-box experience that can be extended to your own, pre-existing authentication providers (known as strategies). The Auth APIs in Backstage serve two purposes: identify the user and provide a way for plugins to request access to third-party services on behalf of the user. We’ve already implemented Google and GitHub authentication to provide examples and to get you started. - + +{/* truncate */} ## What is Passport? diff --git a/microsite/blog/2020-08-05-announcing-backstage-software-templates.md b/microsite/blog/2020-08-05-announcing-backstage-software-templates.md index f9db71d3c4..5d0541f031 100644 --- a/microsite/blog/2020-08-05-announcing-backstage-software-templates.md +++ b/microsite/blog/2020-08-05-announcing-backstage-software-templates.md @@ -10,7 +10,8 @@ authorURL: https://twitter.com/stalund - + +{/* truncate */} ## Balancing autonomy and standardization diff --git a/microsite/blog/2020-09-08-announcing-tech-docs.md b/microsite/blog/2020-09-08-announcing-tech-docs.md index d83a9d0dbc..8c693c658e 100644 --- a/microsite/blog/2020-09-08-announcing-tech-docs.md +++ b/microsite/blog/2020-09-08-announcing-tech-docs.md @@ -10,7 +10,8 @@ Since we [open sourced Backstage](https://backstage.io/blog/2020/03/16/announcin - + +{/* truncate */} Internally, we call it TechDocs. It’s the most used plugin at Spotify by far — accounting for about 20% of our Backstage traffic (even though it is just one of 130+ plugins). Its popularity is evidence of something simple: We made documentation so easy to create, find, and use — people actually use it. diff --git a/microsite/blog/2020-09-23-backstage-cncf-sandbox.md b/microsite/blog/2020-09-23-backstage-cncf-sandbox.md index 70ef06f242..f14f51ce55 100644 --- a/microsite/blog/2020-09-23-backstage-cncf-sandbox.md +++ b/microsite/blog/2020-09-23-backstage-cncf-sandbox.md @@ -8,7 +8,8 @@ authorURL: https://twitter.com/stalund ![cncf](assets/cncf-sandbox/cncf.png) - + +{/* truncate */} Backstage garnered quite a bit of interest from developers and organizations when it was first announced, and community interest continues to grow as plugins and new features are added with the open source community. We released the open source version of Backstage ‘early’. That was intentional. Because even though we’ve been using Backstage internally for years, we wanted the open source version to be developed with input and contributions from the community. And that’s exactly the product that’s going into the [CNCF Sandbox](https://www.cncf.io/sandbox-projects/) today. diff --git a/microsite/blog/2020-09-30-backstage-design-system.md b/microsite/blog/2020-09-30-backstage-design-system.md index fc227ea5d3..85b70dee9a 100644 --- a/microsite/blog/2020-09-30-backstage-design-system.md +++ b/microsite/blog/2020-09-30-backstage-design-system.md @@ -8,7 +8,8 @@ authorURL: http://twitter.com/katherinemzhou We are excited to launch the Backstage Design System, which includes a [Figma UI kit](https://www.figma.com/community/file/850673348101741100), a rich set of [reusable code components](http://backstage.io/storybook) on Storybook, and [Guidelines](https://backstage.io/docs/dls/design) for designers and developers as they build plugins for Backstage. - + +{/* truncate */} ## Not just the way it looks diff --git a/microsite/blog/2020-09-30-plugin-marketplace.md b/microsite/blog/2020-09-30-plugin-marketplace.md index f4e9b749e2..5c45583df0 100644 --- a/microsite/blog/2020-09-30-plugin-marketplace.md +++ b/microsite/blog/2020-09-30-plugin-marketplace.md @@ -12,7 +12,8 @@ Now you may be thinking, “Yeah, sure, that sounds nice and all, but how does B ![plugins](https://backstage.io/img/cards-plugins.png) - + +{/* truncate */} Think of plugins as a mini version of an infrastructure tool or service — just the parts you need, made quick and easy. The advantage of using a Backstage plugin instead of a tool’s dedicated UI is that all your infrastructure is packaged into a “single pane of glass” instead of being spread out like independently built “islands”. Once you grow your infrastructure portfolio, the complexity really starts to add up. The Backstage plugin model allows you to add more tools without increasing the cognitive load for your users. diff --git a/microsite/blog/2020-10-22-cost-insights-plugin.md b/microsite/blog/2020-10-22-cost-insights-plugin.md index b3b615c20b..82721b7f19 100644 --- a/microsite/blog/2020-10-22-cost-insights-plugin.md +++ b/microsite/blog/2020-10-22-cost-insights-plugin.md @@ -11,7 +11,8 @@ How did Spotify save millions on cloud costs within a matter of months?? We made Are we turning engineers into accountants? Nope, we’re just letting engineers do what they do best, in the place that feels natural to them: inside Backstage. - + +{/* truncate */} ## Why put a cost management tool in the hands of engineers? diff --git a/microsite/blog/2020-12-22-stability-index.md b/microsite/blog/2020-12-22-stability-index.md index e49abb1a35..60df5d8e74 100644 --- a/microsite/blog/2020-12-22-stability-index.md +++ b/microsite/blog/2020-12-22-stability-index.md @@ -10,7 +10,8 @@ authorURL: https://github.com/Rugvip ![Animation cycling between stability index scores](assets/2020-12-22/stability-index-hero.gif) - + +{/* truncate */} Backstage has a great and growing community of users and contributors. With so much valuable feedback, this inevitably means that sometimes we will go back and revise design decisions that introduce breaking changes. Furthermore, as we continue to ship new features and systems, we’ll continue this cycle of iterating, gathering feedback, and iterating again before reaching a stable API. diff --git a/microsite/blog/2021-01-12-new-backstage-feature-kubernetes-for-service-owners.md b/microsite/blog/2021-01-12-new-backstage-feature-kubernetes-for-service-owners.md index 7b0686aae7..00b369d0cb 100644 --- a/microsite/blog/2021-01-12-new-backstage-feature-kubernetes-for-service-owners.md +++ b/microsite/blog/2021-01-12-new-backstage-feature-kubernetes-for-service-owners.md @@ -11,7 +11,8 @@ TLDR; We’re rethinking the Kubernetes developer experience with a new feature: And since Backstage uses the native Kubernetes API, the feature works with whichever cloud provider (AWS, Azure, GCP, etc.) or managed service (OpenShift, IBM Cloud, GKE, etc.) you already use. - + +{/* truncate */} ## The missing link between K8s and your service diff --git a/microsite/blog/2021-05-20-adopting-backstage.md b/microsite/blog/2021-05-20-adopting-backstage.md index 0a606fbe60..c0f922dddc 100644 --- a/microsite/blog/2021-05-20-adopting-backstage.md +++ b/microsite/blog/2021-05-20-adopting-backstage.md @@ -8,7 +8,8 @@ authorURL: https://www.linkedin.com/in/austinlamon One of the greatest strengths of Backstage also presents a never-ending challenge: Backstage is highly customizable and allows you to easily build a unique developer portal suited to your organization’s needs. The downside of this flexibility is that it can be hard to know where to start. Backstage can do so many things — integrating every part of your tech infrastructure and developer experience — but if you set off building a developer portal without a plan, it’s easy to get overwhelmed by all the possibilities. To help you form your plan, this post will detail how Spotify came to design our internal portal and recommend potential models for you to use when designing and building your own. - + +{/* truncate */} ## Infrastructure as tech culture diff --git a/microsite/blog/2021-06-22-spotify-backstage-is-growing.md b/microsite/blog/2021-06-22-spotify-backstage-is-growing.md index 35285c5e04..06dfcf8ecb 100644 --- a/microsite/blog/2021-06-22-spotify-backstage-is-growing.md +++ b/microsite/blog/2021-06-22-spotify-backstage-is-growing.md @@ -13,7 +13,8 @@ In order to grow Backstage further, Spotify is increasing the support we provide And while Spotify remains committed to maturing the Backstage platform — both as original creator and active maintainer — we also want to make room for the community to take greater ownership. Backstage may have started inside Spotify, but it belongs to all of you. So, we hope you join us in what’s next. - + +{/* truncate */} ## What’s next: More support for adopters and contributors diff --git a/microsite/blog/2021-06-24-announcing-backstage-search-platform.md b/microsite/blog/2021-06-24-announcing-backstage-search-platform.md index d96b5153ad..dfa36ce3bb 100644 --- a/microsite/blog/2021-06-24-announcing-backstage-search-platform.md +++ b/microsite/blog/2021-06-24-announcing-backstage-search-platform.md @@ -13,7 +13,8 @@ So, you don’t just get an improved out-of-the-box experience for searching wha With one query, your teams can find exactly what they’re looking for: anything and everything. - + +{/* truncate */} ## Search and explore diff --git a/microsite/blog/2021-07-26-software-templates-are-now-in-beta.md b/microsite/blog/2021-07-26-software-templates-are-now-in-beta.md index b646fbdb22..8ba7d9b810 100644 --- a/microsite/blog/2021-07-26-software-templates-are-now-in-beta.md +++ b/microsite/blog/2021-07-26-software-templates-are-now-in-beta.md @@ -9,7 +9,8 @@ authorImageURL: https://avatars.githubusercontent.com/u/3645856?v=4 **TLDR**; At a high level, Backstage performs three main jobs: [Create, Manage, and Explore](https://backstage.io/blog/2021/05/20/adopting-backstage#three-jobs-create-manage-explore). Throughout the year, we’ve been focussed on improving the stability and scalability of these areas while enhancing the feature sets based upon requests from the community. Software Templates — which enable push-button deployments with all your standards and best practices built-in — is our first feature-complete release candidate to graduate to beta. Read on to learn how this release improves template customization and flexibility, as well as performance. - + +{/* truncate */} Let’s rewind a little bit, around a year in fact. Backstage had been open sourced, and we released our first version of Software Templates and our Scaffolder plugin. diff --git a/microsite/blog/2021-09-16-the-techdocs-beta-has-landed.md b/microsite/blog/2021-09-16-the-techdocs-beta-has-landed.md index 27df0b3a44..4c97723765 100644 --- a/microsite/blog/2021-09-16-the-techdocs-beta-has-landed.md +++ b/microsite/blog/2021-09-16-the-techdocs-beta-has-landed.md @@ -9,7 +9,8 @@ authorImageURL: https://avatars.githubusercontent.com/u/3496491?v=4 **TLDR:** Another beta has landed! We continue to focus on improving the stability and scalability of Backstage while enhancing its functionality. Thanks to focused efforts from the TechDocs core team and community, we're happy to say that TechDocs — [our docs-like-code solution](https://backstage.io/blog/2020/09/08/announcing-tech-docs) for all the software in your catalog — is now, after [Software Templates](https://backstage.io/blog/2021/07/26/software-templates-are-now-in-beta), the second core feature to graduate to beta. - + +{/* truncate */} In addition to new features and improvements, we made numerous compatibility updates ahead of this feature release. You'll find support for a variety of CI systems, cloud storage solutions, and source control systems — so that TechDocs works for most orgs, right out of box. But there's much more to explore in this beta, thanks to contributions from the community. diff --git a/microsite/blog/2021-09-30-50-public-adopters.md b/microsite/blog/2021-09-30-50-public-adopters.md index 6a4652b99f..4177d039d3 100644 --- a/microsite/blog/2021-09-30-50-public-adopters.md +++ b/microsite/blog/2021-09-30-50-public-adopters.md @@ -11,7 +11,8 @@ We’re excited to celebrate an important milestone for the Backstage community: Before digging into why we believe this is so important, we want to send a huge “thank you” to all the Backstage adopters and contributors who have helped grow the Backstage community. First, to the publicly listed adopters as your visible support for the project excites others to learn more about Backstage. Second, to those non-listed adopters, many of whom still engage in the community via issues, comments, or code contributions. Thank you! - + +{/* truncate */} ## Why we care about public adopters diff --git a/microsite/blog/2021-12-20-backstage-wrapped-2021.md b/microsite/blog/2021-12-20-backstage-wrapped-2021.md index 2a6234a9f6..bd1f21052b 100644 --- a/microsite/blog/2021-12-20-backstage-wrapped-2021.md +++ b/microsite/blog/2021-12-20-backstage-wrapped-2021.md @@ -15,7 +15,8 @@ In 2021 we’ve seen the project and community grow in every dimension, reaching Now let’s hear from the maintainers and look at the stats! - + +{/* truncate */} ## The community grew…and grew diff --git a/microsite/blog/2022-01-25-backstage-homepage-templates.md b/microsite/blog/2022-01-25-backstage-homepage-templates.md index 8ca8b7373e..ad07245184 100644 --- a/microsite/blog/2022-01-25-backstage-homepage-templates.md +++ b/microsite/blog/2022-01-25-backstage-homepage-templates.md @@ -11,7 +11,8 @@ _This blog post is co-authored by Emma Indal ([@emmaindal](https://github.com/em _TLDR;_ We’re excited to announce the arrival of homepage templates for Backstage. It can be intimidating to build up your own instance of Backstage, so we decided to make your life a bit easier by giving you an out-of-the-box homepage to hit the ground running. This template can be found in our [Backstage Storybook](https://backstage.io/storybook/?path=/story/plugins-home-templates--default-template), as well as future templates that we build. - + +{/* truncate */} ## Why homepage templates? diff --git a/microsite/blog/2022-03-04-backstage-upgrade-helper.md b/microsite/blog/2022-03-04-backstage-upgrade-helper.md index 3f4fc6da77..dbf52a6ef0 100644 --- a/microsite/blog/2022-03-04-backstage-upgrade-helper.md +++ b/microsite/blog/2022-03-04-backstage-upgrade-helper.md @@ -9,7 +9,8 @@ authorImageURL: https://avatars.githubusercontent.com/u/8433119?v=4 _TLDR;_ The Spotify team recently announced [Backstage Upgrade Helper](https://backstage.github.io/upgrade-helper): a tool that helps adopters keep their Backstage application up-to-date. **Spoiler alert**: this is also a hidden and heartwarming tale about the beauty of open source innovation. - + +{/* truncate */} ## Upgrading Backstage was a common pain point diff --git a/microsite/blog/2022-03-16-backstage-turns-two.md b/microsite/blog/2022-03-16-backstage-turns-two.md index 172fb7b971..22421f234e 100644 --- a/microsite/blog/2022-03-16-backstage-turns-two.md +++ b/microsite/blog/2022-03-16-backstage-turns-two.md @@ -9,7 +9,8 @@ authorImageURL: https://avatars1.githubusercontent.com/u/1236238?s=460&v=4 **TLDR:** Backstage has turned two. Of course, this is software, so we expect things to move fast. But when you have a passionate, worldwide community building together, we’ve now seen firsthand just how fast that can be. We’re marking our second year as a community by becoming a CNCF incubating project, reaching 100 public adopters, releasing version 1.0 of the core app, and other very nice birthday gifts. Rather than a toddler finding their feet, Backstage today is beginning to look awfully grown-up for a two-year-old. - + +{/* truncate */} ## Out of the Sandbox and into Incubation diff --git a/microsite/blog/2022-03-17-backstage-1.0.md b/microsite/blog/2022-03-17-backstage-1.0.md index 5afbc3d1ee..a91aedf81f 100644 --- a/microsite/blog/2022-03-17-backstage-1.0.md +++ b/microsite/blog/2022-03-17-backstage-1.0.md @@ -10,7 +10,8 @@ authorImageURL: https://avatars.githubusercontent.com/u/6010860?v=4 _TL;DR:_ If you’ve been waiting for Backstage to come out of beta, we’re excited to announce that Backstage 1.0 is here! - + +{/* truncate */} It’s been two years since Spotify [open sourced Backstage](https://backstage.io/blog/2020/03/16/announcing-backstage) so companies of all shapes and sizes — and in every industry all over the world — could build highly extensible and customized developer portals to best suit their organization’s needs and culture. Now hundreds of adopters are using Backstage as the single pane of glass for their core development, managing millions of components and technical documentation, and helping hundreds of thousands of developers be more productive and happy. diff --git a/microsite/blog/2022-05-13-techdocs-addon-framework.md b/microsite/blog/2022-05-13-techdocs-addon-framework.md index 1c88989dd6..73bba8be12 100644 --- a/microsite/blog/2022-05-13-techdocs-addon-framework.md +++ b/microsite/blog/2022-05-13-techdocs-addon-framework.md @@ -12,7 +12,8 @@ _This blog post is co-authored by Eric Peterson ([@iamEAP](https://github.com/ia _TL;DR:_ Introducing the TechDocs Addon Framework — a way for us all to contribute and share additional features, TechDocs Addons, on top of the base docs-like-code experience. - + +{/* truncate */} [TechDocs](https://backstage.io/docs/features/techdocs/) is a centralized platform for publishing, viewing, and discovering technical documentation across an entire organization. It's a solid foundation! But TechDocs doesn't solve higher order documentation needs on its own such as: How do you create and reinforce a culture of documentation? How do you build trust in the quality of technical documentation? diff --git a/microsite/blog/2022-07-19-releasing-backstage-search-1.0.md b/microsite/blog/2022-07-19-releasing-backstage-search-1.0.md index 4c63e21f21..9fef067388 100644 --- a/microsite/blog/2022-07-19-releasing-backstage-search-1.0.md +++ b/microsite/blog/2022-07-19-releasing-backstage-search-1.0.md @@ -13,7 +13,8 @@ We first released the Backstage Search Platform over a year ago. Backstage Searc Backstage Search Platform makes it possible for you to search across your entire software ecosystem. With a Search platform that is customizable and extendable, you can identify your needs within your organization and set up search to solve these problems. Whether it is to search through the Software Catalog or technical documentation generated by the TechDocs plugin. - + +{/* truncate */} ## So what is Backstage Search 1.0? diff --git a/microsite/blog/2022-08-23-backstage-security-audit.md b/microsite/blog/2022-08-23-backstage-security-audit.md index d81b9b1cf6..a36b9e87d2 100644 --- a/microsite/blog/2022-08-23-backstage-security-audit.md +++ b/microsite/blog/2022-08-23-backstage-security-audit.md @@ -11,7 +11,8 @@ authorURL: https://github.com/Rugvip As an [Incubating project](https://www.cncf.io/blog/2022/03/15/backstage-project-joins-the-cncf-incubator/) within the [Cloud Native Computing Foundation (CNCF)](https://www.cncf.io/), Backstage was fortunate enough to take advantage of a sponsored security audit. The [Open Source Technology Improvement Fund (OSTIF)](https://ostif.org/) sponsored the audit as part of its ongoing efforts to secure the open source software ecosystem, and the audit itself was performed by [X41 D-Sec](https://x41-dsec.de/). Our goal with the audit was to evaluate and improve Backstage’s security posture, focusing on the core Backstage framework and plugins. - + +{/* truncate */} ## Report Findings and Fixes diff --git a/microsite/blog/2022-09-08-fyi-plugin-analytics-api.md b/microsite/blog/2022-09-08-fyi-plugin-analytics-api.md index 4fba242e3e..7e3d1748b8 100644 --- a/microsite/blog/2022-09-08-fyi-plugin-analytics-api.md +++ b/microsite/blog/2022-09-08-fyi-plugin-analytics-api.md @@ -10,7 +10,8 @@ authorImageURL: https://avatars.githubusercontent.com/u/3496491?v=4 ![The Plugin Analytics API](assets/22-09-08/analytics-api-fyi.png) - + +{/* truncate */} ## What is the plugin analytics API? diff --git a/microsite/blog/2022-11-15-linux-foundation-introduction-to-backstage-course.md b/microsite/blog/2022-11-15-linux-foundation-introduction-to-backstage-course.md index b762bd7e97..609545db10 100644 --- a/microsite/blog/2022-11-15-linux-foundation-introduction-to-backstage-course.md +++ b/microsite/blog/2022-11-15-linux-foundation-introduction-to-backstage-course.md @@ -9,7 +9,8 @@ Backstage continues to grow in [popularity and maturity](https://roadie.io/blog/ [![Introduction to Backstage: Developer Portals Made Easy (LFS142x): Enroll!](assets/22-11-15/Introduction-to-Backstage-Developer-Portals-Made-Easy-2-768x432.png)](https://www.edx.org/course/introduction-to-backstage-developer-portals-made-easy) - + +{/* truncate */} The course, [Introduction to Backstage: Developer Portals Made Easy (LFS142x)](https://www.edx.org/course/introduction-to-backstage-developer-portals-made-easy), starts discussing the benefits of adopting a Developer Portal. Then, it dives into what is Backstage, its main features (Catalog, Scaffolder, TechDocs), and how to map its capabilities to your organization. At last, it provides tips on how to connect with the community to ease up your adoption journey. diff --git a/microsite/blog/2022-12-19-backstage-wrapped-2022.md b/microsite/blog/2022-12-19-backstage-wrapped-2022.md index 4986b3effd..3425bec1f5 100644 --- a/microsite/blog/2022-12-19-backstage-wrapped-2022.md +++ b/microsite/blog/2022-12-19-backstage-wrapped-2022.md @@ -12,7 +12,8 @@ Our community is full of people from across the globe who bring incredible engag But before anticipating too much, let’s share some stats of this amazing 2022. - + +{/* truncate */} ## We grew … a lot! diff --git a/microsite/blog/2023-01-31-incremental-entity-provider.md b/microsite/blog/2023-01-31-incremental-entity-provider.md index b878c66871..4306360d84 100644 --- a/microsite/blog/2023-01-31-incremental-entity-provider.md +++ b/microsite/blog/2023-01-31-incremental-entity-provider.md @@ -8,7 +8,8 @@ At the heart of [Backstage](https://backstage.io/) is the [Backstage Software Ca ![catalog pipeline](assets/2023-01-31/catalog-pipeline.png) - + +{/* truncate */} A common use case is for an organization to want to surface ownership and metadata about repositories. Backstage provides a mechanism for discovering and transforming repository information into a standard data structure and persisting it into the Backstage [Catalog](https://backstage.io/docs/features/software-catalog/). This process is known as ingestion, where all data is transformed into a standard Backstage data structure known as an entity. Entities in the Catalog’s data store are accessible to the Backstage App via the REST API. diff --git a/microsite/blog/2023-02-06-whats-ahead-in-2023.md b/microsite/blog/2023-02-06-whats-ahead-in-2023.md index f989973ca0..ef877a0868 100644 --- a/microsite/blog/2023-02-06-whats-ahead-in-2023.md +++ b/microsite/blog/2023-02-06-whats-ahead-in-2023.md @@ -10,7 +10,8 @@ authorURL: https://github.com/leemills83 Okay, everyone. Time to move on from all the 2022 reflections, Top 10 lists, and Wrapped(s), and turn our gaze in the other direction — towards 2023. As the Backstage team moves into the new year, we find ourselves asking those perennial questions: How can we continue to grow and enhance the Backstage community? How can we improve the experience for those adopting Backstage? How can we give the best support to Backstage contributors? - + +{/* truncate */} Well, we don’t have all the answers, but we do have some. So we wanted to share more on three ongoing initiatives aimed at moving the needle forward for these three distinct, yet interrelated, questions. diff --git a/microsite/blog/2023-02-15-backend-system-alpha.md b/microsite/blog/2023-02-15-backend-system-alpha.md index 9970945f67..0b00314475 100644 --- a/microsite/blog/2023-02-15-backend-system-alpha.md +++ b/microsite/blog/2023-02-15-backend-system-alpha.md @@ -11,7 +11,8 @@ For the past year, the Backstage maintainer team has been spending time to give We’re happy to announce that the [v1.11](https://backstage.io/docs/releases/v1.11.0) release includes the public alpha of the [new Backstage backend system](https://backstage.io/docs/backend-system/)! The system has already been available to use for some time, as some of you have already found, but this alpha release marks the point where we are finally ready to encourage widespread adoption by plugin builders. We still don’t recommend that you use this new system in your production setups just yet, more on that later. - + +{/* truncate */} ## History of the Backstage backend system diff --git a/microsite/blog/2023-03-15-backstage-turns-3.md b/microsite/blog/2023-03-15-backstage-turns-3.md index 317cdc0c4d..f5b04538b5 100644 --- a/microsite/blog/2023-03-15-backstage-turns-3.md +++ b/microsite/blog/2023-03-15-backstage-turns-3.md @@ -9,7 +9,8 @@ authorImageURL: https://avatars.githubusercontent.com/u/3645856?v=4 **TL;DR** Spotify released Backstage into open source three years ago today. Since then, the community has grown by leaps and bounds to stretch across the globe (and the Discord server!). Now that Backstage is a threenager, the growing pains are real. So, on this birthday, we want to cover our collective efforts to make it easier to adopt and contribute to Backstage. - + +{/* truncate */} ## They grow up so fast, don’t they? diff --git a/microsite/docusaurus.config.js b/microsite/docusaurus.config.js index 429a2b546f..e6137b572b 100644 --- a/microsite/docusaurus.config.js +++ b/microsite/docusaurus.config.js @@ -70,11 +70,8 @@ module.exports = { ], markdown: { preprocessor({ filePath, fileContent }) { - // Replace HTML comments with empty strings in files that are not in the blog folder, - // as the syntax is backwards compatible with MDX2 in Docusarus. - if (!filePath.startsWith(`${__dirname}/blog`)) { - return fileContent.replace(//gs, ''); - } + // Replace all HTML comments with emtpy strings as these are not supported by MDXv2. + return fileContent.replace(//gs, ''); }, }, webpack: {