Improving Alt text for images - #3189
Open
dessyordanova wants to merge 1 commit into
Open
Conversation
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
Documentation rendering/validity issues remain in the modified control-templates article (list formatting and an invalid closing tag in a code snippet).
Once you've addressed the issues Copilot identified, you can request another Copilot review.
This review doesn't count toward merge requirements. Sign up for the private preview to control whether Copilot approvals count.
Pull request overview
This PR improves documentation accessibility and discoverability by updating image alt text across multiple WPF documentation sections (themes, installation, .NET migration, controls like RadComboBox/RadChartView, and cloud integration topics).
Changes:
- Replaces generic/empty alt text with more descriptive, context-rich descriptions.
- Standardizes alt text to better communicate what each screenshot/diagram demonstrates.
- Updates a large set of documentation pages to improve accessibility and search relevance.
File summaries
| File | Description |
|---|---|
| styling-and-appearance/xaml-vs-noxaml.md | Updates image alt text for the NoXaml/Xaml DLL properties screenshot. |
| styling-and-appearance/themes-suite/windows8.md | Updates theme screenshot alt text for Windows 8 theme documentation. |
| styling-and-appearance/themes-suite/windows11.md | Updates theme screenshot alt text for Windows 11 theme documentation. |
| styling-and-appearance/themes-suite/visualstudio2019.md | Updates theme screenshot alt text for Visual Studio 2019 theme documentation. |
| styling-and-appearance/themes-suite/visualstudio2013.md | Updates theme screenshot alt text for Visual Studio 2013 theme documentation. |
| styling-and-appearance/themes-suite/office2019.md | Updates theme screenshot alt text for Office 2019 theme documentation. |
| styling-and-appearance/themes-suite/office2016touch.md | Updates theme screenshot alt text for Office 2016 Touch theme documentation. |
| styling-and-appearance/themes-suite/office2013.md | Updates theme screenshot alt text for Office 2013 theme documentation. |
| styling-and-appearance/themes-suite/material.md | Updates theme screenshot alt text for Material theme documentation. |
| styling-and-appearance/themes-suite/green.md | Updates theme screenshot alt text for Green theme documentation. |
| styling-and-appearance/themes-suite/fluent.md | Updates theme screenshot alt text for Fluent theme documentation. |
| styling-and-appearance/themes-suite/crystal.md | Updates theme screenshot alt text for Crystal theme documentation. |
| styling-and-appearance/themes-suite/available-themes.md | Improves alt text for theme preview images in the available themes table. |
| styling-and-appearance/theme-helper.md | Updates alt text for ThemeHelper visual states screenshot. |
| styling-and-appearance/styling-apperance-setting-a-theme-overview.md | Updates alt text for implicit styles theme folder screenshot. |
| styling-and-appearance/styling-apperance-modifying-default-styles.md | Updates alt text for screenshots illustrating template/style editing steps. |
| styling-and-appearance/styling-apperance-editing-control-templates.md | Updates alt text and reformats content around control template extraction workflow. |
| styling-and-appearance/stylemanager/common-styling-apperance-setting-theme-wpf.md | Updates alt text for StyleManager theme application screenshot. |
| styling-and-appearance/how-to/styling-apperance-themes-runtime.md | Updates alt text for runtime theme switching tutorial screenshots. |
| styling-and-appearance/how-to/styling-apperance-switching-icons-at-runtime.md | Updates alt text for icon switching tutorial screenshots. |
| styling-and-appearance/glyphs/common-styles-appearance-glyphs-radglyph.md | Updates alt text for RadGlyph and glyph font comparison screenshots. |
| netcore/migrate-to-netcore.md | Updates alt text for .NET migration steps and Visual Studio dialogs. |
| netcore/deploy-netcore-app.md | Updates alt text for .NET deployment/publish workflow screenshots. |
| installation/manual-setup-guides/vs-toolbox.md | Updates alt text for Visual Studio Toolbox setup screenshots. |
| installation/manual-setup-guides/visual-studio-templates.md | Updates alt text for Visual Studio template screenshots. |
| installation/manual-setup-guides/visual-studio-extensions/extensions-upgrading.md | Updates alt text for upgrade wizard screenshots. |
| installation/manual-setup-guides/visual-studio-extensions/extensions-project-latest-version-acquirer.md | Updates alt text for latest version acquirer tool screenshots. |
| installation/manual-setup-guides/visual-studio-extensions/extensions-project-creation.md | Updates alt text for project creation wizard screenshots. |
| installation/manual-setup-guides/visual-studio-extensions/extensions-project-convert.md | Updates alt text for project conversion wizard screenshots. |
| installation/manual-setup-guides/visual-studio-extensions/extensions-project-configuration.md | Updates alt text for project configuration wizard screenshots. |
| installation/manual-setup-guides/visual-studio-extensions/extensions-overview.md | Updates alt text for Visual Studio extensions overview screenshots. |
| installation/manual-setup-guides/visual-studio-extensions/extensions-options.md | Updates alt text for Visual Studio extensions options screenshots. |
| installation/manual-setup-guides/visual-studio-extensions/extensions-itemtemplates.md | Updates alt text for item template workflow screenshots. |
| installation/manual-setup-guides/nuget/package-source-setup.md | Updates alt text for NuGet API key generation screenshot. |
| installation/manual-setup-guides/nuget/nuget-keys.md | Updates alt text for NuGet key management screenshots. |
| installation/manual-setup-guides/installing-demos.md | Updates alt text for demos install/run screenshots. |
| installation/manual-setup-guides/installation-guide.md | Updates alt text for installation workflow screenshots. |
| installation/licensing/license-limitations.md | Updates alt text for trial licensing dialogs/screenshots. |
| installation/licensing/license-activation-errors-and-warnings.md | Updates alt text for license warning screenshots. |
| installation/licensing/installing-license-to-ci-services.md | Adds descriptive alt text for CI license activation screenshots. |
| controls/radcombobox/overview.md | Updates alt text for RadComboBox overview screenshot. |
| controls/radcombobox/howto/enable-disable-radcombobox-items.md | Updates alt text for enable/disable RadComboBox items screenshots. |
| controls/radcombobox/getting-started.md | Updates alt text for RadComboBox getting started screenshot. |
| controls/radcombobox/general-information-visual-structure.md | Updates alt text for RadComboBox visual structure screenshots. |
| controls/radcombobox/features/filteringbehavior.md | Updates alt text for filtering behavior result screenshots. |
| controls/radchartview/styles-and-templates/customizing-cartesianchart-series.md | Updates alt text for styling/template examples. |
| controls/radchartview/series/polarchart-series/area-series/radarareaseries.md | Updates alt text for RadarAreaSeries screenshot. |
| controls/radchartview/series/polarchart-series/area-series/polarareaseries.md | Updates alt text for PolarAreaSeries screenshot. |
| controls/radchartview/series/piechart-series/pieseries.md | Updates alt text for PieSeries screenshots. |
| controls/radchartview/series/piechart-series/doughnutseries.md | Updates alt text for DoughnutSeries screenshots. |
| controls/radchartview/series/funnelchart-series/funnelseries.md | Updates alt text for FunnelSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/point-series/scatterpointseries.md | Updates alt text for ScatterPointSeries screenshot. |
| controls/radchartview/series/cartesianchart-series/point-series/point.md | Updates alt text for PointSeries screenshot. |
| controls/radchartview/series/cartesianchart-series/line-series/steplineseries.md | Updates alt text for StepLineSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/line-series/splineseries.md | Updates alt text for SplineSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/line-series/scattersplineseries.md | Updates alt text for ScatterSplineSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/line-series/scatterlineseries.md | Updates alt text for ScatterLineSeries screenshot. |
| controls/radchartview/series/cartesianchart-series/line-series/lineseries.md | Updates alt text for LineSeries screenshot. |
| controls/radchartview/series/cartesianchart-series/financial-series/ohlcseries.md | Updates alt text for OhlcSeries screenshot. |
| controls/radchartview/series/cartesianchart-series/financial-series/candlestickseries.md | Updates alt text for CandlestickSeries screenshot. |
| controls/radchartview/series/cartesianchart-series/bubble-series/scatterbubbleseries.md | Updates alt text for ScatterBubbleSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/bubble-series/bubbleseries.md | Updates alt text for BubbleSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/bar-series/scatterrangebarseries.md | Updates alt text for ScatterRangeBarSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/bar-series/rangebarseries.md | Updates alt text for RangeBarSeries screenshot. |
| controls/radchartview/series/cartesianchart-series/bar-series/histogram.md | Updates alt text for histogram-related screenshots. |
| controls/radchartview/series/cartesianchart-series/bar-series/errorbarseries.md | Updates alt text for ErrorBarSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/bar-series/boxplotseries.md | Updates alt text for BoxPlotSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/bar-series/barseries.md | Updates alt text for BarSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/area-series/stepareaseries.md | Updates alt text for StepAreaSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/area-series/splineareaseries.md | Updates alt text for SplineAreaSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/area-series/scattersplineareaseries.md | Updates alt text for ScatterSplineAreaSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/area-series/scatterareaseries.md | Updates alt text for ScatterAreaSeries screenshot. |
| controls/radchartview/series/cartesianchart-series/area-series/rangesplineseries.md | Updates alt text for RangeSplineSeries screenshots. |
| controls/radchartview/series/cartesianchart-series/area-series/rangeseries.md | Updates alt text for RangeSeries screenshot. |
| controls/radchartview/series/cartesianchart-series/area-series/areaseries.md | Updates alt text for AreaSeries screenshot. |
| controls/radchartview/populating-with-data/static-data.md | Updates alt text for static data chart screenshots. |
| controls/radchartview/populating-with-data/series-databinding.md | Updates alt text for series data binding screenshots. |
| controls/radchartview/populating-with-data/chartdatasource.md | Updates alt text for ChartDataSource screenshots. |
| controls/radchartview/populating-with-data/binding-to-data-table.md | Updates alt text for DataTable binding screenshot. |
| controls/radchartview/populating-with-data/binding-the-color-of-series-items.md | Updates alt text for color-binding screenshots. |
| controls/radchartview/overview.md | Updates alt text for RadChartView overview screenshot. |
| controls/radchartview/multiple-chart-series.md | Updates alt text for multi-series chart screenshot. |
| controls/radchartview/howto/hide-zerro-values-pieseries.md | Updates alt text for pie series zero-label screenshots. |
| controls/radchartview/getting-started/introduction.md | Updates alt text for getting started “missing axes/series” screenshots. |
| controls/radchartview/features/radlegend-support.md | Updates alt text for RadLegend integration screenshots. |
| controls/radchartview/features/plot-area.md | Updates alt text for plot area screenshots. |
| controls/radchartview/features/palettes/paletteentry.md | Updates alt text for palette entry screenshot. |
| controls/radchartview/features/palettes/introduction.md | Updates alt text for palette introduction screenshot. |
| controls/radchartview/features/palettes/custom-palettes.md | Updates alt text for custom palettes screenshot. |
| controls/radchartview/features/originvalue.md | Updates alt text for origin value screenshot. |
| controls/radchartview/features/labels/smart-labels.md | Updates alt text for smart labels screenshots. |
| controls/radchartview/features/labels/label-definition.md | Updates alt text for label definition screenshots. |
| controls/radchartview/features/labels/label-connectors.md | Updates alt text for label connectors screenshot. |
| controls/radchartview/features/labels/custom-smart-labels-strategy.md | Updates alt text for custom smart labels strategy screenshots. |
| controls/radchartview/features/labels/custom-series-labels-strategy.md | Updates alt text for custom series labels strategy screenshots. |
| controls/radchartview/features/hovermode.md | Updates alt text for hover mode screenshot. |
| controls/radchartview/features/empty-content.md | Updates alt text for empty content screenshots. |
| controls/radchartview/features/design-time-support.md | Updates alt text for design-time support screenshots. |
| controls/radchartview/features/combinemode.md | Updates alt text for combine mode screenshots. |
| controls/radchartview/features/chartseriesprovider.md | Updates alt text for SeriesProvider screenshot. |
| controls/radchartview/features/cartesianchartgrid-and-polarchartgrid.md | Updates alt text for chart grid screenshots. |
| controls/radchartview/features/behaviors/trackball.md | Updates alt text for trackball behavior screenshots. |
| controls/radchartview/features/behaviors/tooltip.md | Updates alt text for tooltip behavior screenshots. |
| controls/radchartview/features/behaviors/selection.md | Updates alt text for selection behavior screenshots. |
| controls/radchartview/features/behaviors/panzoom.md | Updates alt text for pan/zoom behavior screenshots. |
| controls/radchartview/features/behaviors/crosshair.md | Updates alt text for crosshair behavior screenshot. |
| controls/radchartview/features/annotations/plotband.md | Updates alt text for plot band annotation screenshots. |
| controls/radchartview/features/annotations/overview.md | Updates alt text for annotation classes diagram. |
| controls/radchartview/features/annotations/markedzone.md | Updates alt text for marked zone annotation screenshots/diagrams. |
| controls/radchartview/features/annotations/labels.md | Updates alt text for annotation label screenshots/diagrams. |
| controls/radchartview/features/annotations/gridline.md | Updates alt text for grid line annotation screenshots. |
| controls/radchartview/features/annotations/annotations-provider.md | Updates alt text for annotations provider screenshots. |
| controls/radchartview/features/animations.md | Updates alt text for animation GIFs/screenshots. |
| controls/radchartview/empty-data-points.md | Updates alt text for empty data point screenshot. |
| controls/radchartview/axes/polaraxis.md | Updates alt text for polar axis screenshot. |
| controls/radchartview/axes/plotmode.md | Updates alt text for plot mode screenshots. |
| controls/radchartview/axes/multipleaxes.md | Updates alt text for multiple axes screenshots. |
| controls/radchartview/axes/logarithmicaxis.md | Updates alt text for logarithmic axis screenshots. |
| controls/radchartview/axes/label.md | Updates alt text for axis label screenshots. |
| controls/radchartview/axes/inversed-axis.md | Updates alt text for inverted axis comparison screenshot. |
| controls/radchartview/axes/gap-length.md | Updates alt text for gap length screenshot. |
| controls/radchartview/axes/datetimeaxes.md | Updates alt text for DateTime axis screenshots. |
| controls/radchartview/axes/categoricalaxis.md | Updates alt text for categorical axis screenshots. |
| controls/radchartview/axes/axis.md | Updates alt text for axis feature screenshots. |
| controls/radchartview/axes/axis-smart-labels.md | Updates alt text for axis smart labels screenshots. |
| controls/radchartview/axes/axis-range.md | Updates alt text for axis range screenshots. |
| common-information/validation-error-template.md | Updates alt text for validation error template screenshot. |
| common-information/upgrade-api-analyzer.md | Updates alt text for Upgrade API Analyzer screenshots. |
| common-information/troubleshooting/popup-content-position.md | Updates alt text for popup alignment troubleshooting screenshots. |
| common-information/touch-support.md | Updates alt text for touch gesture table images. |
| common-information/mvvm-helpers/common-event-to-command-behavior.md | Updates alt text for EventToCommandBehavior screenshots. |
| common-information/geometry_extension.md | Updates alt text for Geometry Extension screenshot. |
| common-information/consuming-data/linq-to-ado-net-entity-data-model.md | Updates alt text for Entity Data Model wizard screenshots. |
| common-information/consuming-data/ado-net-data-service.md | Updates alt text for OData connected service screenshots. |
| common-information/common-localization.md | Updates alt text for localization-related screenshots. |
| common-information/common-export-support.md | Updates alt text for export support screenshot. |
| cloud-integration/google-cloud/overview.md | Updates alt text for Google Cloud overview image. |
| cloud-integration/google-cloud/getting-started.md | Updates alt text for Google Cloud API Library screenshot. |
| cloud-integration/google-cloud/connect-to-data-in-the-cloud/datastore.md | Updates alt text for Datastore NuGet and results screenshots. |
| cloud-integration/google-cloud/cognitive-services/translation.md | Updates alt text for Translation NuGet and results screenshots. |
| cloud-integration/google-cloud/cloud-storage.md | Updates alt text for Cloud Storage NuGet and results screenshots. |
| cloud-integration/azure/overview.md | Updates alt text for Azure overview image. |
| cloud-integration/azure/connect-to-data-in-the-cloud/sql-database.md | Updates alt text for Azure SQL + EF wizard screenshots. |
| cloud-integration/azure/blob-storage.md | Updates alt text for Azure Blob Storage NuGet and results screenshots. |
| cloud-integration/amazon-web-services/storage.md | Updates alt text for AWS S3 NuGet and results screenshots. |
| cloud-integration/amazon-web-services/ses.md | Updates alt text for AWS SES NuGet and results screenshots. |
| cloud-integration/amazon-web-services/overview.md | Updates alt text for AWS overview image. |
| cloud-integration/amazon-web-services/getting-started.md | Updates alt text for AWS Toolkit/console getting started screenshots. |
| cloud-integration/amazon-web-services/connect-to-data-in-the-cloud/rds.md | Updates alt text for AWS RDS setup wizard screenshots. |
| cloud-integration/amazon-web-services/connect-to-data-in-the-cloud/dynamo-db.md | Updates alt text for DynamoDB NuGet and console screenshot. |
Review details
- Files reviewed: 150/150 changed files
- Comments generated: 3
- Review effort level: Lite
We're testing this review assessment. Please use 👍 or 👎 to tell us if it's correct.
| ``` | ||
|
|
||
| Let's say that you have line series with large number of data points and visualized labels | ||
| Let's say that you have line series with large number of data points and visualized labels |
Comment on lines
+110
to
+112
| __Figure 3: Visual Studio designer context menu__ | ||
|
|
||
|  |
Comment on lines
+148
to
+152
| <Grid> | ||
| <telerik:RadListBox Style="{StaticResource RadListBoxStyle1}" ItemsSource="{Binding ListBoxItems}" /> | ||
| </Grid> | ||
| <UserControl> | ||
| ``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Well-written alt text improves the accessibility, discoverability, and overall effectiveness of a documentation article. By providing a clear description of screenshots, diagrams, and other visual elements, alt text helps search engines better understand and index page content, while also giving AI-powered search and retrieval systems additional context about the topics covered. As a result, documentation can become easier to find via image search, more relevant in search results, and more likely to be accurately surfaced by LLM-based assistants and enterprise knowledge search tools.
Handled sections:
Getting Started
Installation
Style & Appearance
AI tools
Common Information
NET Core support
Cloud Integration
RadComboBox
RadChartView