Merge pull request #22518 from npiyush97/a11y

Microsite: a11y fixes
This commit is contained in:
Fredrik Adelöw
2024-01-31 15:48:17 +01:00
committed by GitHub
8 changed files with 62 additions and 26 deletions
+7 -7
View File
@@ -36,7 +36,7 @@ The Software Catalog is available to browse at `/catalog`. If you've followed
[Getting Started with Backstage](../../getting-started), you should be able to
browse the catalog at `http://localhost:3000`.
![](../../assets/software-catalog/software-catalog-home.png)
![screenshot of software catalog](../../assets/software-catalog/software-catalog-home.png)
## Adding components to the catalog
@@ -55,7 +55,7 @@ There are 3 ways to add components to the catalog:
Users can register new components by going to `/create` and clicking the
**REGISTER EXISTING COMPONENT** button:
![](../../assets/software-catalog/bsc-register-1.png)
![screenshot of manually register existing component](../../assets/software-catalog/bsc-register-1.png)
Backstage expects the full URL to the YAML in your source control. Example:
@@ -66,7 +66,7 @@ https://github.com/backstage/backstage/blob/master/packages/catalog-model/exampl
_More examples can be found
[here](https://github.com/backstage/backstage/tree/master/packages/catalog-model/examples)._
![](../../assets/software-catalog/bsc-register-2.png)
![screenshot of creating new components](../../assets/software-catalog/bsc-register-2.png)
It is important to note that any kind of software can be registered in
Backstage. Even if the software is not maintained by your company (SaaS
@@ -100,7 +100,7 @@ More information about catalog configuration can be found
Teams owning the components are responsible for maintaining the metadata about
them, and do so using their normal Git workflow.
![](../../assets/software-catalog/bsc-edit.png)
![screenshot of updating component metadata](../../assets/software-catalog/bsc-edit.png)
Once the change has been merged, Backstage will automatically show the updated
metadata in the software catalog after a short while.
@@ -112,14 +112,14 @@ in user. But you can also switch to _All_ to see all the components across your
company's software ecosystem. Basic inline _search_ and _column filtering_ makes
it easy to browse a big set of components.
![](../../assets/software-catalog/bsc-search.png)
![screenshot of finding software in the catalog](../../assets/software-catalog/bsc-search.png)
## Starring components
For easy and quick access to components you visit frequently, Backstage supports
_starring_ of components:
![](../../assets/software-catalog/bsc-starred.png)
![screenshot of starred components](../../assets/software-catalog/bsc-starred.png)
## Integrated tooling through plugins
@@ -130,7 +130,7 @@ infrastructure UIs (and incurring additional cognitive overhead each time they
make a context switch), most of these tools can be organized around the entities
in the catalog.
![tools](https://backstage.io/assets/images/tabs-abfdf72185d3ceb1d92c4237f7f78809.png)
![screenshot of tools](https://backstage.io/assets/images/tabs-abfdf72185d3ceb1d92c4237f7f78809.png)
The Backstage platform can be customized by incorporating
[existing open source plugins](https://github.com/backstage/backstage/tree/master/plugins),
+1 -1
View File
@@ -35,4 +35,4 @@ Backstage was originally built by Spotify and then donated to the CNCF.
Backstage is currently in the Incubation phase. Read the announcement
[here](https://backstage.io/blog/2022/03/16/backstage-turns-two#out-of-the-sandbox-and-into-incubation).
<img src="https://backstage.io/img/cncf-white.svg" width="400" />
<img src="https://backstage.io/img/cncf-white.svg" alt="CNCF logo" width="400" />
+14 -14
View File
@@ -12,31 +12,31 @@ The assets below are all in `.svg` format. Other formats are available in the
## Backstage logo
<a href="https://backstage.io/logo_assets/svg/Logo_White.svg">
<img src="https://backstage.io/logo_assets/svg/Logo_White.svg" width="600" />
<a href="https://backstage.io/logo_assets/svg/Logo_White.svg" aria-label='Link to Backstage White logo svg'>
<img src="https://backstage.io/logo_assets/svg/Logo_White.svg" alt='Backstage White logo' width="600" />
</a>
<a href="https://backstage.io/logo_assets/svg/Logo_Teal.svg">
<img src="https://backstage.io/logo_assets/svg/Logo_Teal.svg" width="600" />
<a href="https://backstage.io/logo_assets/svg/Logo_Teal.svg" aria-label='Link to Backstage Teal logo svg'>
<img src="https://backstage.io/logo_assets/svg/Logo_Teal.svg" alt='Backstage Teal logo' width="600" />
</a>
<a href="https://backstage.io/logo_assets/svg/Logo_Black.svg">
<img src="https://backstage.io/logo_assets/svg/Logo_Black.svg" width="600" className="logoWhite" class="logoWhite" />
<a href="https://backstage.io/logo_assets/svg/Logo_Black.svg" aria-label='Link to Backstage Black logo svg'>
<img src="https://backstage.io/logo_assets/svg/Logo_Black.svg" alt='Backstage Black logo' width="600" className="logoWhite" class="logoWhite" />
</a>
## Backstage icon
<div>
<a href="https://backstage.io/logo_assets/svg/Icon_White.svg">
<img src="https://backstage.io/logo_assets/svg/Icon_White.svg" width="180" height="180" />
<a href="https://backstage.io/logo_assets/svg/Icon_White.svg" aria-label='Link to Backstage White icon'>
<img src="https://backstage.io/logo_assets/svg/Icon_White.svg" alt='Backstage White Icon' width="180" height="180" />
</a>
<a href="https://backstage.io/logo_assets/svg/Icon_Teal.svg">
<img src="https://backstage.io/logo_assets/svg/Icon_Teal.svg" width="180" height="180" />
<a href="https://backstage.io/logo_assets/svg/Icon_Teal.svg" aria-label='Link to Backstage Teal icon'>
<img src="https://backstage.io/logo_assets/svg/Icon_Teal.svg" alt='Backstage Teal Icon' width="180" height="180" />
</a>
<a href="https://backstage.io/logo_assets/svg/Icon_Gradient.svg">
<img src="https://backstage.io/logo_assets/svg/Icon_Gradient.svg" width="180" height="180" />
<a href="https://backstage.io/logo_assets/svg/Icon_Gradient.svg" aria-label='Link to Backstage Gradient icon'>
<img src="https://backstage.io/logo_assets/svg/Icon_Gradient.svg" alt='Backstage Gradient Icon' width="180" height="180" />
</a>
<a href="https://backstage.io/logo_assets/svg/Icon_Black.svg">
<img src="https://backstage.io/logo_assets/svg/Icon_Black.svg" width="180" height="180" className="logoWhite" class="logoWhite" />
<a href="https://backstage.io/logo_assets/svg/Icon_Black.svg" aria-label='Link to Backstage Black icon'>
<img src="https://backstage.io/logo_assets/svg/Icon_Black.svg" alt='Backstage Black Icon' width="180" height="180" className="logoWhite" class="logoWhite" />
</a>
</div>
+1 -1
View File
@@ -40,7 +40,7 @@ Out of the box, Backstage includes:
Backstage is a CNCF Incubation project after graduating from Sandbox. Read the announcement
[here](https://backstage.io/blog/2022/03/16/backstage-turns-two#out-of-the-sandbox-and-into-incubation).
<img src="https://backstage.io/img/cncf-white.svg" width="400" />
<img src="https://backstage.io/img/cncf-white.svg" alt="CNCF logo" width="400" />
## Benefits
+1 -1
View File
@@ -22,7 +22,7 @@ The permission framework was designed with a few key properties in mind:
- **Integrators** can author or configure policies that define which users can take certain actions upon which resources.
![](../assets/permissions/permission-framework-overview.drawio.svg)
![backstage framework overview](../assets/permissions/permission-framework-overview.drawio.svg)
1. The user triggers a request to perform some action. The request specifies the authorization details using the permission specified by the plugin (in this case, a resource read action).
@@ -37,4 +37,10 @@ $page-header-height: 44px;
padding-right: 2rem;
}
select[class*='hs-input'] {
color: black;
}
input[class*='hs-button'] {
color: black;
}
}
@@ -32,6 +32,7 @@
position: absolute;
text-align: center;
font-weight: bold;
color: black;
transform: translateY(var(--translateY)) translateX(var(--translateX))
rotate(var(--rotation));
+31 -2
View File
@@ -7,7 +7,7 @@
--ifm-color-primary-darker: #2e9e8a;
--ifm-color-primary-darkest: #268271;
}
// for docs and releases
#__docusaurus {
.theme-doc-markdown {
a {
@@ -15,7 +15,36 @@
}
}
}
// for blog
#__docusaurus {
.row {
.col {
&--7 {
a {
text-decoration: underline;
}
}
}
}
}
// for community page
#__docusaurus {
div[class^='communityPage'],
div[class*='communityPage'] {
a:not([class]) {
text-decoration: underline;
}
}
}
// for plugin page
#__docusaurus {
div[class^='pluginsPage'],
div[class*='pluginsPage'] {
a:not([class]) {
text-decoration: underline;
}
}
}
.footerLogo {
background-image: url(/img/logo.svg);
background-repeat: no-repeat;