Merge pull request #668 from HeidiSteen/heidist-rag

Added linebreaks in sample output for readability

Author: prmerger-automator[bot]

articles/search/tutorial-rag-build-solution-maximize-relevance.md

@@ -107,7 +107,12 @@ print(response.choices[0].message.content)
 Output from this request might look like the following example.
 
 ```
-Yes, there are cloud formations specific to oceans and large bodies of water. A notable example is "cloud streets," which are parallel rows of clouds that form over the Bering Strait in the Arctic Ocean. These cloud streets occur when wind blows from a cold surface like sea ice over warmer, moister air near the open ocean, leading to the formation of spinning air cylinders. Clouds form along the upward cycle of these cylinders, while skies remain clear along the downward cycle (Source: page-21.pdf).
+Yes, there are cloud formations specific to oceans and large bodies of water. 
+A notable example is "cloud streets," which are parallel rows of clouds that form over 
+the Bering Strait in the Arctic Ocean. These cloud streets occur when wind blows from 
+a cold surface like sea ice over warmer, moister air near the open ocean, leading to 
+the formation of spinning air cylinders. Clouds form along the upward cycle of these cylinders, 
+while skies remain clear along the downward cycle (Source: page-21.pdf).
 ```
 
 ## Update the index for semantic ranking and scoring profiles
@@ -264,13 +269,20 @@ Output from a semantically ranked and boosted query might look like the followin
 ```
 Yes, there are specific cloud formations influenced by oceans and large bodies of water:
 
-- **Stratus Clouds Over Icebergs**: Low stratus clouds can frame holes over icebergs, such as Iceberg A-56 in the South Atlantic Ocean, likely due to thermal instability caused by the iceberg (source: page-39.pdf).
+- **Stratus Clouds Over Icebergs**: Low stratus clouds can frame holes over icebergs, 
+such as Iceberg A-56 in the South Atlantic Ocean, likely due to thermal instability caused 
+by the iceberg (source: page-39.pdf).
 
-- **Undular Bores**: These are wave structures in the atmosphere created by the collision of cool, dry air from a continent with warm, moist air over the ocean, as seen off the coast of Mauritania (source: page-23.pdf).
+- **Undular Bores**: These are wave structures in the atmosphere created by the collision 
+of cool, dry air from a continent with warm, moist air over the ocean, as seen off the 
+coast of Mauritania (source: page-23.pdf).
 
-- **Ship Tracks**: These are narrow clouds formed by water vapor condensing around tiny particles from ship exhaust. They are observed over the oceans, such as in the Pacific Ocean off the coast of California (source: page-31.pdf).
+- **Ship Tracks**: These are narrow clouds formed by water vapor condensing around tiny 
+particles from ship exhaust. They are observed over the oceans, such as in the Pacific Ocean 
+off the coast of California (source: page-31.pdf).
 
-These specific formations are influenced by unique interactions between atmospheric conditions and the presence of large water bodies or objects within them.
+These specific formations are influenced by unique interactions between atmospheric conditions 
+and the presence of large water bodies or objects within them.
 ```
 
 Adding semantic ranking and scoring profiles positively affects the response from the LLM by promoting results that meet scoring criteria and are semantically relevant. 

articles/search/tutorial-rag-build-solution-pipeline.md

@@ -346,20 +346,26 @@ Chunk:
 Swirling Bloom off Patagonia
 Argentina
 
-Interesting art often springs out of the convergence of different ideas and influences. And so it is with nature. 
+Interesting art often springs out of the convergence of different ideas and influences. 
+And so it is with nature. 
 
-Off the coast of Argentina, two strong ocean currents converge and often stir up a colorful brew, as shown in this Aqua image from 
+Off the coast of Argentina, two strong ocean currents converge and often stir up a colorful 
+brew, as shown in this Aqua image from 
 
 December 2010. 
 
-This milky green and blue bloom formed on the continental shelf off of Patagonia, where warmer, saltier waters from the subtropics 
+This milky green and blue bloom formed on the continental shelf off of Patagonia, where warmer, 
+saltier waters from the subtropics 
 
-meet colder, fresher waters flowing from the south. Where these currents collide, turbulent eddies and swirls form, pulling nutrients 
+meet colder, fresher waters flowing from the south. Where these currents collide, turbulent 
+eddies and swirls form, pulling nutrients 
 
-up from the deep ocean. The nearby Rio de la Plata also deposits nitrogen- and iron-laden sediment into the sea. Add in some 
+up from the deep ocean. The nearby Rio de la Plata also deposits nitrogen- and iron-laden 
+sediment into the sea. Add in some 
 ...
 
-while others terminate in water. The San Rafael and San Quintín glaciers (shown at the right) are the icefield’s largest. Both have 
+while others terminate in water. The San Rafael and San Quintín glaciers (shown at the right) 
+are the icefield’s largest. Both have 
 
 been receding rapidly in the past 30 years.
 ```

articles/search/tutorial-rag-build-solution-query.md

@@ -130,7 +130,13 @@ In this response, the answer is based on five inputs (`top=5`) consisting of chu
 Results from the first query `"What's the NASA earth book about?"` should look similar to the following example.
 
 ```
-The NASA Earth book is about the intricate and captivating science of our planet, studied through NASA's unique perspective and tools. It presents Earth as a dynamic and complex system, observed through various cycles and processes such as the water cycle and ocean circulation. The book combines stunning satellite images with detailed scientific insights, portraying Earth’s beauty and the continuous interaction of land, wind, water, ice, and air seen from above. It aims to inspire and demonstrate that the truth of our planet is as compelling as any fiction.
+The NASA Earth book is about the intricate and captivating science of our planet, studied 
+through NASA's unique perspective and tools. It presents Earth as a dynamic and complex 
+system, observed through various cycles and processes such as the water cycle and ocean 
+circulation. The book combines stunning satellite images with detailed scientific insights, 
+portraying Earth’s beauty and the continuous interaction of land, wind, water, ice, and 
+air seen from above. It aims to inspire and demonstrate that the truth of our planet is 
+as compelling as any fiction.
 
 Source: page-8.pdf
 ```
@@ -173,13 +179,19 @@ search_results = search_client.search(
 Results from the filtered query should now look similar to the following response. Notice the emphasis on ice cover.
 
 ```
-The NASA Earth book showcases various geographic and environmental features of Earth through satellite imagery, highlighting remarkable landscapes and natural phenomena. 
-
-- It features extraordinary views like the Holuhraun Lava Field in Iceland, captured by Landsat 8 during an eruption in 2014, with false-color images illustrating different elements such as ice, steam, sulfur dioxide, and fresh lava ([source](page-43.pdf)).
-- Other examples include the North Patagonian Icefield in South America, depicted through clear satellite images showing glaciers and their changes over time ([source](page-147.pdf)).
-- It documents melt ponds in the Arctic, exploring their effects on ice melting and heat absorption ([source](page-153.pdf)).
+The NASA Earth book showcases various geographic and environmental features of Earth through 
+satellite imagery, highlighting remarkable landscapes and natural phenomena. 
+
+- It features extraordinary views like the Holuhraun Lava Field in Iceland, captured by 
+Landsat 8 during an eruption in 2014, with false-color images illustrating different elements 
+such as ice, steam, sulfur dioxide, and fresh lava ([source](page-43.pdf)).
+- Other examples include the North Patagonian Icefield in South America, depicted through 
+clear satellite images showing glaciers and their changes over time ([source](page-147.pdf)).
+- It documents melt ponds in the Arctic, exploring their effects on ice melting and 
+- heat absorption ([source](page-153.pdf)).
 
-Overall, the book uses satellite imagery to give insights into Earth's dynamic systems and natural changes.
+Overall, the book uses satellite imagery to give insights into Earth's dynamic systems 
+and natural changes.
 ```
 
 ## Change the inputs
@@ -189,14 +201,20 @@ Increasing or decreasing the number of inputs to the LLM can have a large effect
 Here's one example of what the model returns after increasing the inputs to 8.
 
 ```
-The NASA Earth book features a range of satellite images capturing various natural phenomena across the globe. These include:
-
-- The Holuhraun Lava Field in Iceland documented by Landsat 8 during a 2014 volcanic eruption (Source: page-43.pdf).
-- The North Patagonian Icefield in South America, highlighting glacial landscapes captured in a rare cloud-free view in 2017 (Source: page-147.pdf).
-- The impact of melt ponds on ice sheets and sea ice in the Arctic, with images from an airborne research campaign in Alaska during July 2014 (Source: page-153.pdf).
-- Sea ice formations at Shikotan, Japan, and other notable geographic features in various locations recorded by different Landsat missions (Source: page-168.pdf).
-
-Summary: The book showcases satellite images of diverse Earth phenomena, such as volcanic eruptions, icefields, and sea ice, to provide insights into natural processes and landscapes.
+The NASA Earth book features a range of satellite images capturing various natural phenomena 
+across the globe. These include:
+
+- The Holuhraun Lava Field in Iceland documented by Landsat 8 during a 2014 volcanic 
+eruption (Source: page-43.pdf).
+- The North Patagonian Icefield in South America, highlighting glacial landscapes 
+captured in a rare cloud-free view in 2017 (Source: page-147.pdf).
+- The impact of melt ponds on ice sheets and sea ice in the Arctic, with images from 
+an airborne research campaign in Alaska during July 2014 (Source: page-153.pdf).
+- Sea ice formations at Shikotan, Japan, and other notable geographic features in various 
+locations recorded by different Landsat missions (Source: page-168.pdf).
+
+Summary: The book showcases satellite images of diverse Earth phenomena, such as volcanic 
+eruptions, icefields, and sea ice, to provide insights into natural processes and landscapes.
 ```
 
 Because the model is bound to the grounding data, the answer becomes more expansive as you increase size of the input. You can use relevance tuning to potentially generate more focused answers.
@@ -224,7 +242,8 @@ Sources:\n{sources}
 Output from changing just the prompt, otherwise retaining all aspects of the previous query, might look like this example. 
 
 ```
-The NASA Earth book appears to showcase various locations on Earth captured through satellite imagery, highlighting natural phenomena and geographic features. For instance, the book includes:
+The NASA Earth book appears to showcase various locations on Earth captured through satellite imagery, 
+highlighting natural phenomena and geographic features. For instance, the book includes:
 
 - The Holuhraun Lava Field in Iceland, detailing volcanic activity and its observation via Landsat 8.
 - The North Patagonian Icefield in South America, covering its glaciers and changes over time as seen by Landsat 8.