Improved docs

Author: andrey-helldar

docs/topics/receipt-sitemap.topic

@@ -6,23 +6,38 @@
         xsi:noNamespaceSchemaLocation="https://resources.jetbrains.com/writerside/1.0/topic.v2.xsd"
         title="Sitemap" id="receipt-sitemap" help-id="sitemap">
 
-    <link-summary>Recipe for creating a sitemap</link-summary>
-    <card-summary>Recipe for creating a sitemap</card-summary>
-    <web-summary>Recipe for creating a sitemap</web-summary>
+    <link-summary>How to create a sitemap feed</link-summary>
+    <card-summary>Step-by-step recipe for creating a sitemap</card-summary>
+    <web-summary>Step-by-step guide to creating a sitemap feed</web-summary>
 
     <show-structure depth="3" />
 
+    <p>
+        This recipe walks you through creating a product sitemap feed using Laravel Feeds. You will generate the
+        necessary classes, implement the feed logic, expose the files via the filesystem, and reference the sitemap
+        from a root sitemap.xml if needed.
+    </p>
+
     <chapter title="Create files" id="create_files">
+        <p>
+            Generate the feed and its item class using the console command:
+        </p>
         <code-block lang="bash">
             %command-make-simple% Sitemaps/Product -%command-shortcut-item%
         </code-block>
     </chapter>
 
-    <chapter title="Filling the feed" id="filling_the_feed">
+    <chapter title="Fill the feed" id="filling_the_feed">
+        <p>
+            Implement the feed root element, attributes, query builder, filename, and item mapping as shown below:
+        </p>
         <code-block lang="php" src="receipt-sitemap-feed.php" />
     </chapter>
 
-    <chapter title="Filling the feed item" id="filling_the_feed_item">
+    <chapter title="Fill the feed item" id="filling_the_feed_item">
+        <p>
+            Define the XML element name and map model properties to sitemap tags:
+        </p>
         <code-block lang="php" src="receipt-sitemap-feed-item.php" />
     </chapter>
 
@@ -32,14 +47,14 @@
 
     <chapter title="Links" id="links">
         <p>
-            Don't forget to add a link to the folder with site maps in the
+            Add a filesystem link to the directory containing your sitemaps in the
             <a href="https://github.com/laravel/laravel/blob/12.x/config/filesystems.php#L76-L78">config/filesystems.php</a> configuration file:
         </p>
 
         <code-block lang="php" src="receipt-sitemap-links.php" include-lines="5-" />
 
         <p>
-            After that, run the console command:
+            Then create the public symlink so the files are accessible via the browser:
         </p>
 
         <code-block lang="bash">
@@ -51,11 +66,17 @@
         <include from="snippet-generate.topic" element-id="feed_generate" />
     </chapter>
 
-    <chapter title="Adding a link to the general sitemap.xml file" id="adding_a_link_to_the_general_sitemap_xml_file">
+    <chapter title="Add a link to the root sitemap.xml" id="adding_a_link_to_the_general_sitemap_xml_file">
+        <p>
+            If you maintain a root sitemap.xml file that references other sitemaps, add an entry like this:
+        </p>
         <code-block lang="xml" src="receipt-sitemap-root.xml" />
     </chapter>
 
     <chapter title="Result" id="result">
+        <p>
+            A generated sitemap.xml for your products will look like this:
+        </p>
         <code-block lang="xml" src="receipt-sitemap-feed.xml" />
     </chapter>
 

docs/topics/snippet-generate.topic

@@ -9,7 +9,7 @@
 
     <snippet id="feed_generate">
         <p>
-            Now you can generate a feed using a console command:
+            Generate the feed by running the following console command:
         </p>
 
         <code-block lang="bash">
@@ -19,8 +19,7 @@
 
     <snippet id="check_operation">
         <p>
-            Check the <a href="create-feeds.topic">operation/migration</a>
-            file that was created for you and run the console command:
+            Review the generated <a href="create-feeds.topic">operation/migration</a> file and then run the appropriate console command:
         </p>
 
         <code-block lang="bash">