Merge pull request #231241 from PatrickFarley/comvis-updates

[cog svcs] use-case revision from dybe

Author: v-regandowner

articles/cognitive-services/Computer-vision/media/use-cases/elephant.png

@@ -9,45 +9,61 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: computer-vision
 ms.topic: conceptual
-ms.date: 07/22/2022
+ms.date: 03/17/2023
 ms.author: pafarley
 ---
 
 
-# Overview: Generate alt text of images with Image Analysis
+# Overview: Generate image alt-text with Image Analysis
 
-Grow your customer base by making your products and services more accessible. Generate a description of an image in human-readable language, using complete sentences. Computer Vision's algorithms generate various descriptions based on the objects identified in the image. The descriptions are each evaluated, and a confidence score is generated. You then get the list of descriptions, ordered from highest confidence score to lowest.
+## What is alt text?
 
-## Image captioning example 
+Alt text, or alternative text, is an HTML attribute added to the `<img>` tag that displays images on an application or web page. It looks like this in plain HTML code: 
 
-The following screenshot is an example of automatically generated alt text for an image.
+`<img src="elephant.jpg" alt="An elephant in a grassland">`
 
-:::image type="content" source="media/use-cases/studio-alt-text.png" alt-text="Screenshot of Vision Studio with a caption generated for an image of cows.":::
+Alt text enables website owners to describe an image in plain text. These image descriptions improve accessibility by enabling screen readers such as Microsoft Narrator, JAWS, and NVDA to accurately communicate image content to their visually impaired and blind users. 
 
-## Adding alt text to images 
+Alt text is also vital for image search engine optimization (SEO). It helps search engines understand the visual content in your images. The search engine is then better able to include and rank your website in search results when users search for the content in your website.  
 
-Alternative text (alt text) is descriptive text that conveys the meaning and context of a visual item in a digital setting, such as on an app or web page. When screen readers such as Microsoft Narrator, JAWS, and NVDA reach digital content with alt text, they read the alt text aloud, allowing people to better understand what is on the screen. Well written, descriptive alt text dramatically reduces ambiguity and improves the user experience. Alt text needs to convey the purpose and meaning of an image, which requires understanding and interpretation in addition to object detection.
+## Auto-generate alt text with Image Analysis  
 
-## Key features  
+Image Analysis offers image captioning models that generate one-sentence descriptions of image visual content. You can use these AI generated captions as alt text for your images.  
 
-- Human-readable captions with confidence: Generate a description of an entire image in human-readable language, using complete sentences. Computer Vision's algorithms generate various descriptions based on the objects identified in the image. The descriptions are each evaluated and a confidence score generated. A list is then returned ordered from highest confidence score to lowest. 
-- Multiple captions available: You can specify the number of possible captions it will generate and choose the one that works best for your business.
+:::image type="content" source="media/use-cases/elephant.png" alt-text="An elephant in a grassland.":::
 
-## Benefits for your business 
+Auto-generated caption: "An elephant in a grassland."
 
-Accessibility is the design of products, devices, services, vehicles, or environments to be usable by people with disabilities. Accessibility has been an increasingly important topic in product and service development as it makes digital experiences available to more people in the world. Accessibility will boost your business in multiple ways: 
+Microsoft’s own products such as PowerPoint, Word, and Edge browser use image captioning by Image Analysis to generate alt text. 
 
-- **Improve user experience**: by adding alt text, you make the information in images available to users who are blind or have low vision, as well as users who can't load the images due to internet connection. 
-- **Make images more discoverable and searchable**: adding captions and tags to images will help search engine crawlers find your images and rank them higher in search results.
-- **Meet legal compliance**: there may potentially be legal repercussions for business that aren't accessibility-compliant. Building products with higher accessibility helps the business avoid potential risks of legal action now and in the future.
+:::image type="content" source="media/use-cases/powerpoint-alt-text.png" alt-text="Screenshot of a PowerPoint slide with alt text written on the side." lightbox="media/use-cases/powerpoint-alt-text.png" ::: 
 
- 
+## Benefits for your website 
 
-## Next Steps 
-The following tutorial provides a complete solution to generate alternative text of images on web applications.
+- **Improve accessibility and user experience for blind and low-vision users**. Alt Text makes visual information in images available to screen readers used by blind and low-vision users. 
+- **Meet legal compliance requirements**. Some websites may be legally required to remove all accessibility barriers. Using alt text for accessibility helps website owners minimize risk of legal action now and in the future. 
+- **Make your website more discoverable and searchable**. Image alt text helps search engine crawlers find images on your website more easily and rank them higher in search results.  
 
-> [!div class="nextstepaction"]
-> [Tutorial: Use Computer Vision to generate image metadata](./Tutorials/storage-lab-tutorial.md)
+## Frequently Asked Questions 
+
+### What languages are image captions available in? 
+
+Image captions are available in English, Chinese, Portuguese, Japanese, and Spanish in Image Analysis 3.2 API. In the Image Analysis 4.0 API (preview), image captions are only available in English.
+
+### What confidence threshold should I use? 
+
+To ensure accurate alt text for all images, you can choose to only accept captions above a certain confidence level. The right confidence level varies for each user depending on the type of images and usage scenario.  
 
+In general, we advise a confidence threshold of `0.4` for the Image Analysis 3.2 API and of `0.0` for the Image Analysis 4.0 API (preview).
 
+### What can I do about embarrassing or erroneous captions?  
 
+On rare occasions, image captions can contain embarrassing errors, such as labeling a male-identifying person as a "woman" or labeling an adult woman as a "girl". We encourage users to consider using the latest Image Analysis 4.0 API (preview) which eliminates some errors by supporting gender-neutral captions.
+
+Please report any embarrassing or offensive captions by going to the [Azure portal](https://ms.portal.azure.com/#home) and navigating to the **Feedback** button in the top right.
+
+## Next Steps 
+Follow a quickstart to begin automatically generating alt text by using image captioning on Image Analysis.
+
+> [!div class="nextstepaction"]
+> [Image Analysis quickstart](./quickstarts-sdk/image-analysis-client-library-40.md)