diff --git a/specification/maps/data-plane/Render/stable/2024-04-01/render.json b/specification/maps/data-plane/Render/stable/2024-04-01/render.json
index 6a806a805f00..84c8fe514d0a 100644
--- a/specification/maps/data-plane/Render/stable/2024-04-01/render.json
+++ b/specification/maps/data-plane/Render/stable/2024-04-01/render.json
@@ -200,11 +200,11 @@
},
{
"value": "microsoft.weather.radar.main",
- "description": "Weather radar tiles. Latest weather radar images including areas of rain, snow, ice and mixed conditions. Please see [coverage information](https://aka.ms/AzureMapsWeatherCoverage) for Azure Maps Weather service. To learn more about the Radar data, please see [Weather concepts](https://aka.ms/AzureMapsWeatherConcepts).
\n\nSupports zoom levels 0 through 15. Format: raster (png)."
+ "description": "Weather radar tiles. Latest weather radar images including areas of rain, snow, ice and mixed conditions. For more information on the Azure Maps Weather service coverage, see [Azure Maps weather services coverage](/azure/azure-maps/weather-coverage). For more information on Radar data, see [Weather services in Azure Maps](/azure/azure-maps/weather-services-concepts#radar-images).\n\nSupports zoom levels 0 through 15. Format: raster (png)."
},
{
"value": "microsoft.weather.infrared.main",
- "description": "Weather infrared tiles. Latest Infrared Satellite images shows clouds by their temperature. Please see [coverage information](https://aka.ms/AzureMapsWeatherCoverage) for Azure Maps Weather service. To learn more about the returned Satellite data, please see [Weather concepts](https://aka.ms/AzureMapsWeatherConcepts).
\n\nSupports zoom levels 0 through 15. Format: raster (png)."
+ "description": "Weather infrared tiles. Latest Infrared Satellite images shows clouds by their temperature. For more information, see [Azure Maps weather services coverage](/azure/azure-maps/weather-coverage). For more information about the satellite data returned, see [Weather services in Azure Maps](/azure-maps/weather-services-concepts#satellite-images).\n\nSupports zoom levels 0 through 15. Format: raster (png)."
},
{
"value": "microsoft.traffic.absolute",
@@ -250,7 +250,7 @@
"paths": {
"/map/tile": {
"get": {
- "description": "**Applies to:** see [pricing tiers](https://aka.ms/AzureMapsPricingTier).\n\nThe Get Map Tiles API allows users to request map tiles in vector or raster formats typically to be integrated into a map control or SDK. Some example tiles that can be requested are Azure Maps road tiles, real-time Weather Radar tiles or the map tiles created using [Azure Maps Creator](https://aka.ms/amcreator). By default, Azure Maps uses vector tiles for its web map control (Web SDK) and Android SDK.",
+ "description": "The `Get Map Tiles` API in an HTTP GET request that allows users to request map tiles in vector or raster formats typically to be integrated into a map control or SDK. Some example tiles that can be requested are Azure Maps road tiles, real-time Weather Radar tiles or the map tiles created using [Azure Maps Creator](https://aka.ms/amcreator). By default, Azure Maps uses vector tiles for its web map control ([Web SDK](/azure/azure-maps/about-azure-maps#web-sdk)) and [Android SDK](/azure/azure-maps/about-azure-maps#android-sdk).",
"operationId": "Render_GetMapTile",
"x-ms-client-name": "GetMapTile",
"x-ms-examples": {
@@ -324,7 +324,7 @@
},
"/map/tileset": {
"get": {
- "description": "**Applies to:** see [pricing tiers](https://aka.ms/AzureMapsPricingTier).\n\nThe Get Map Tileset API allows users to request metadata for a tileset.",
+ "description": "The Get Map Tileset API allows users to request metadata for a tileset.",
"operationId": "Render_GetMapTileset",
"x-ms-examples": {
"Successful Tileset Request": {
@@ -360,7 +360,7 @@
},
"/map/attribution": {
"get": {
- "description": "**Applies to:** see [pricing tiers](https://aka.ms/AzureMapsPricingTier).\n\nThe Get Map Attribution API allows users to request map copyright attribution information for a section of a tileset.",
+ "description": "The `Get Map Attribution` API allows users to request map copyright attribution information for a section of a tileset.",
"operationId": "Render_GetMapAttribution",
"x-ms-examples": {
"Successful Attribution Request": {
@@ -417,7 +417,7 @@
},
"/map/statetile": {
"get": {
- "description": "**Applies to:** see [pricing tiers](https://aka.ms/AzureMapsPricingTier).\n\nFetches state tiles in vector format typically to be integrated into indoor maps module of map control or SDK. The map control will call this API after user turns on dynamic styling (see [Zoom Levels and Tile Grid](https://docs.microsoft.com/azure/location-based-services/zoom-levels-and-tile-grid))",
+ "description": "Fetches state tiles in vector format typically to be integrated into indoor maps module of map control or SDK. The map control will call this API after user turns on dynamic styling (see [Zoom Levels and Tile Grid](/azure/location-based-services/zoom-levels-and-tile-grid))",
"operationId": "Render_GetMapStateTile",
"x-ms-examples": {
"Successful State Tile Request": {
@@ -475,7 +475,7 @@
},
"/map/copyright/caption/{format}": {
"get": {
- "description": "**Applies to:** see [pricing tiers](https://aka.ms/AzureMapsPricingTier).\n\nCopyrights API is designed to serve copyright information for Render Tile \nservice. In addition to basic copyright for the whole map, API is serving \nspecific groups of copyrights for some countries/regions.\n\nAs an alternative to copyrights for map request, one can receive captions\nfor displaying the map provider information on the map.",
+ "description": "The `Get Copyright Caption` API is an HTTP GET request designed to serve copyright information to be used in conjunction with tiles requested from the Render service. In addition to a basic copyright for the whole map, it can serve specific groups of copyrights for some countries/regions.\n\nAs an alternative to copyrights for map request, one can receive captions for displaying the map provider information on the map.",
"operationId": "Render_GetCopyrightCaption",
"x-ms-examples": {
"Successful Copyright Caption Request": {
@@ -708,7 +708,7 @@
},
"/map/copyright/bounding/{format}": {
"get": {
- "description": "**Applies to:** see [pricing tiers](https://aka.ms/AzureMapsPricingTier).\n\nReturns copyright information for a given bounding box. Bounding-box requests should specify the minimum and maximum longitude and latitude (EPSG-3857) coordinates",
+ "description": "Returns copyright information for a given bounding box. Bounding-box requests should specify the minimum and maximum longitude and latitude (EPSG-3857) coordinates",
"operationId": "Render_GetCopyrightFromBoundingBox",
"x-ms-examples": {
"Successful BoundingBox Copyright Request": {
@@ -750,7 +750,7 @@
},
"/map/copyright/tile/{format}": {
"get": {
- "description": "**Applies to:** see [pricing tiers](https://aka.ms/AzureMapsPricingTier).\n\nCopyrights API is designed to serve copyright information for Render Tile service. In addition to basic copyright for the whole map, API is serving specific groups of copyrights for some countries/regions.\nReturns the copyright information for a given tile. To obtain the copyright information for a particular tile, the request should specify the tile's zoom level and x and y coordinates (see: Zoom Levels and Tile Grid).",
+ "description": "Returns the copyright information for a given tile. To obtain the copyright information for a particular tile, the request should specify the tile's zoom level and x and y coordinates. For more information, see: [Zoom Levels and Tile Grid](/azure/azure-maps/zoom-levels-and-tile-grid).\n\nCopyrights API is designed to serve copyright information for Render service. In addition to basic copyright for the whole map, API is serving specific groups of copyrights for some countries/regions.",
"operationId": "Render_GetCopyrightForTile",
"x-ms-examples": {
"Successful Tile Copyright Request": {
@@ -795,7 +795,7 @@
},
"/map/copyright/world/{format}": {
"get": {
- "description": "**Applies to:** see [pricing tiers](https://aka.ms/AzureMapsPricingTier).\n\nCopyrights API is designed to serve copyright information for Render Tile service. In addition to basic copyright for the whole map, API is serving specific groups of copyrights for some countries/regions.\nReturns the copyright information for the world. To obtain the default copyright information for the whole world, do not specify a tile or bounding box.",
+ "description": "Returns the copyright information for the world. To obtain the default copyright information for the whole world, do not specify a tile or bounding box. \n\nCopyrights API is designed to serve copyright information for Render service. In addition to basic copyright for the whole map, API is serving specific groups of copyrights for some countries/regions. ",
"operationId": "Render_GetCopyrightForWorld",
"x-ms-examples": {
"Successful World Copyright Request": {