.

Author: gildesmarais

astro.config.mjs

@@ -127,19 +127,16 @@ export default defineConfig({
           link: "/",
         },
         {
-          label: "About",
-          link: "/about",
+          label: "Common Use Cases",
+          link: "/common-use-cases",
         },
         {
           label: "Feed Directory",
           link: "/feed-directory/",
         },
-        {
-          label: "Creating Custom Feeds",
-          link: "/html2rss-configs",
-        },
         {
           label: "Web Application",
+          collapsed: true,
           items: [
             "web-application",
             "web-application/getting-started",
@@ -159,6 +156,7 @@ export default defineConfig({
         },
         {
           label: "Ruby Gem",
+          collapsed: true,
           items: [
             "ruby-gem",
             "ruby-gem/installation",
@@ -176,12 +174,22 @@ export default defineConfig({
             },
           ],
         },
+        {
+          label: "About",
+          link: "/about",
+        },
+        {
+          label: "Creating Custom Feeds",
+          link: "/html2rss-configs",
+        },
         {
           label: "Get Involved",
+          collapsed: false,
           autogenerate: { directory: "get-involved" },
         },
         {
           label: "Support",
+          collapsed: true,
           autogenerate: { directory: "support" },
         },
       ],

src/content/docs/about.mdx

@@ -1,11 +1,11 @@
 ---
 title: About html2rss
-description: Learn about html2rss, our mission, principles, and the team behind this open-source project.
+description: Learn about html2rss, the open-source RSS feed generator that helps you follow any website. Discover our mission, principles, and the team behind this powerful tool.
 ---
 
 `html2rss` is an open-source project dedicated to empowering you to take control of your web content. In an age where many websites don't offer traditional RSS feeds, `html2rss` provides a robust and flexible solution to convert almost any HTML content into a structured RSS format.
 
-Started in 2018, the project has evolved into a comprehensive suite of tools designed to help you create and consume RSS feeds effortlessly.
+Since its founding in 2018, the project has evolved into a comprehensive suite of tools designed to help you create and consume RSS feeds effortlessly.
 
 ---
 

src/content/docs/common-use-cases.mdx

@@ -0,0 +1,114 @@
+---
+title: "Common Use Cases"
+description: "See how people use html2rss to stay updated with their favorite websites. Real examples for personal and business use cases."
+---
+
+Discover how people are using html2rss to take control of their web content consumption. These real-world examples show the power and flexibility of creating custom RSS feeds.
+
+---
+
+## Personal Use Cases
+
+### Following Your Favorite Bloggers
+
+Many bloggers don't offer RSS feeds, but you can create them with html2rss. Follow writers you love without relying on social media algorithms.
+
+**Example:** Create a feed for a personal blog that only posts to social media.
+
+### Job Hunting
+
+Track job postings from multiple company websites in one place. Never miss an opportunity again.
+
+**Example:** Follow job boards, company career pages, and industry-specific job sites.
+
+### Local News
+
+Follow your local newspaper or community website to stay informed about your neighborhood.
+
+**Example:** Create feeds for local news sites, community forums, and city government updates.
+
+### Academic Research
+
+Follow new papers and research in your field from multiple sources.
+
+**Example:** Track arXiv submissions, journal publications, and conference proceedings.
+
+### Product Updates
+
+Get notified when software you use releases updates, new features, or security patches.
+
+**Example:** Follow product blogs, changelog pages, and release notes.
+
+### Hobby Communities
+
+Follow forums, communities, and websites related to your hobbies and interests.
+
+**Example:** Track gaming forums, photography communities, or cooking blogs.
+
+---
+
+## Business Use Cases
+
+### Competitor Monitoring
+
+Track what your competitors are posting about - new products, features, or announcements.
+
+**Example:** Follow competitor blogs, press releases, and social media updates.
+
+### Industry News
+
+Follow multiple industry publications in one feed to stay ahead of trends.
+
+**Example:** Aggregate news from industry blogs, trade publications, and thought leaders.
+
+### Customer Support
+
+Monitor customer feedback and support requests across different platforms.
+
+**Example:** Track support forums, review sites, and social media mentions.
+
+### Content Marketing
+
+Follow industry influencers and competitors for content inspiration.
+
+**Example:** Track competitor blogs, industry newsletters, and thought leadership content.
+
+---
+
+## Technical Use Cases
+
+### API Monitoring
+
+Track API documentation updates and changelogs.
+
+**Example:** Follow API documentation sites, developer blogs, and changelog pages.
+
+### Security Updates
+
+Monitor security advisories and vulnerability reports.
+
+**Example:** Track security blogs, CVE databases, and vendor security pages.
+
+### Open Source Projects
+
+Follow multiple open source projects and their updates.
+
+**Example:** Track project blogs, release notes, and community discussions.
+
+---
+
+## Getting Started with Your Use Case
+
+1. **Identify the websites** you want to follow
+2. **Check our [Feed Directory](/feed-directory/)** to see if feeds already exist
+3. **Try the [Web App](/web-application/getting-started)** to create feeds easily
+4. **Learn advanced techniques** with our [Config Guide](/html2rss-configs/)
+
+---
+
+## Need Help?
+
+- **Can't find what you're looking for?** [Browse our Feed Directory](/feed-directory/)
+- **Want to create custom feeds?** [Try the Web App](/web-application/getting-started)
+- **Need advanced features?** [Check our Ruby Gem docs](/ruby-gem/)
+- **Have questions?** [Join our community discussions](https://github.com/orgs/html2rss/discussions)

src/content/docs/html2rss-configs.mdx

@@ -1,17 +1,18 @@
 ---
 title: Creating Custom RSS Feeds
-description: Learn how to create custom RSS feeds using html2rss configuration files
+description: Learn how to create custom RSS feeds using html2rss configuration files. Step-by-step guide for turning any website into an RSS feed with simple YAML configs.
 ---
 
 Want to create RSS feeds for websites that don't offer them? This guide shows you how to write simple configuration files.
 
-**New to html2rss?** Start with the [web app](/web-application/getting-started) or [browse existing feeds](/feed-directory/) first.
+**Getting started?** Start with the [web app](/web-application/getting-started) or [browse existing feeds](/feed-directory/) first.
 
 ---
 
 ## Quick Start
 
 **Need a feed right now?**
+
 1. **[Try the web app](/web-application/getting-started)** - No coding required
 2. **[Browse ready-made feeds](/feed-directory/)** - Use what others created
 3. **Create a config** - When you need custom control (see below)
@@ -23,6 +24,7 @@ Want to create RSS feeds for websites that don't offer them? This guide shows yo
 ## How It Works
 
 A config file is a simple "recipe" that tells html2rss:
+
 1. **Which website** to look at
 2. **What content** to find
 3. **How to organize** it into an RSS feed
@@ -32,6 +34,7 @@ A config file is a simple "recipe" that tells html2rss:
 This tells html2rss basic information about your feed - like giving it a name and telling it which website to look at.
 
 **Example:**
+
 ```yaml
 channel:
   url: https://example.com/blog
@@ -45,6 +48,7 @@ This says: "Look at this website and call the feed 'My Awesome Blog'"
 This is where you tell the html2rss engine exactly what to find on the page. You use CSS selectors (like you might use in web design) to point to specific parts of the webpage.
 
 **Example:**
+
 ```yaml
 selectors:
   items:
@@ -92,6 +96,7 @@ selectors:
 ## Troubleshooting
 
 **Common issues:**
+
 - **No items found?** Check your selectors with browser tools (F12)
 - **Invalid YAML?** Use spaces, not tabs
 - **Website not loading?** Check the URL
@@ -125,16 +130,19 @@ selectors:
 ### What's Next?
 
 **For Beginners:**
+
 - **[Browse the Feed Directory](/feed-directory/)** - See real-world examples
 - **[Try html2rss-web](/web-application/getting-started)** - Create feeds without coding
 - **[Learn more about selectors](/ruby-gem/reference/selectors/)** - Master CSS selectors
 
 **For Contributors:**
+
 - **[Submit your config via GitHub Web](https://github.com/html2rss/html2rss-configs)** - No Git knowledge required!
 - **[Browse existing configs](https://github.com/html2rss/html2rss-configs/tree/master/lib/html2rss/configs)** - See real examples
 - **[Join discussions](https://github.com/orgs/html2rss/discussions)** - Connect with other users
 
 **For Developers:**
+
 - **[Ruby Gem Documentation](/ruby-gem/)** - Full API reference
 - **[Advanced Features](/ruby-gem/how-to/advanced-features/)** - Learn advanced techniques
 - **[Custom HTTP Requests](/ruby-gem/how-to/custom-http-requests/)** - Handle complex scenarios

src/content/docs/index.mdx

@@ -1,41 +1,85 @@
 ---
-title: "Turn Any Website Into an RSS Feed"
-description: "html2rss brings back RSS. It is an open source project with decentralized instances. These instances generate RSS feeds for websites that do not offer them."
+title: "Turn Any Website Into an RSS Feed - Never Miss Updates Again"
+description: "Create RSS feeds from any website - no coding required. Turn blogs, news sites, and forums into RSS feeds you can follow in your favorite reader. Free, open source, and easy to use."
 ---
 
 Ever wished you could follow your favorite websites like a social media feed? The html2rss project makes it possible by creating RSS feeds for any website - even ones that don't offer them.
 
+## 🚀 Get Started in 30 Seconds
+
+**Try it now:** [Browse Ready-Made Feeds](/feed-directory/) | [Create Your First Feed](/web-application/getting-started)
+
 ---
 
-## Why Use RSS Feeds?
+## Why RSS Still Matters Today
+
+**Real examples of what you can do:**
 
-Instead of visiting 20 different websites every day, you can:
+- Follow your favorite blogs without social media algorithms
+- Get notified when your local news site posts about your neighborhood
+- Track job postings from multiple company websites
+- Monitor product updates from software vendors
+- Follow academic papers from your field
 
-- **Get all updates in one place** - your feed reader
-- **Never miss new content** - automatic notifications
-- **Save time** - no more manual checking
-- **Stay organized** - categorize and filter content
+**RSS vs Social Media:**
+
+- ✅ **No algorithms** deciding what you see
+- ✅ **No ads** or sponsored content
+- ✅ **Works with any feed reader** you choose
+- ✅ **Your data stays private**
+- ✅ **Never miss updates** - automatic notifications
+- ✅ **Save time** - no more manual checking
 
 ---
 
 ## What is html2rss?
 
-html2rss is a user-friendly web application that turns any website into an RSS feed. Think of it as a translator that converts website content into a format your feed reader can understand.
+html2rss is a user-friendly tool that turns any website into an RSS feed. Think of it as a translator that converts website content into a format your feed reader can understand.
 
 **Two ways to use html2rss:**
-- **html2rss-web** - Easy-to-use web application (recommended for most users)
-- **html2rss Ruby gem** - For developers and advanced users
+
+- **🌐 Web App** - Point, click, done! Perfect for everyone
+- **⚙️ Ruby Gem** - For developers who want to code their own feeds
 
 ---
 
-## Quick Start
+## 🎯 Choose Your Path
+
+### I'm Getting Started with RSS
+
+1. **[See Examples First](/feed-directory/)** - Browse 100+ ready-made feeds
+2. **[Try the Web App](/web-application/getting-started)** - Create feeds without coding
+3. **[Learn More](/about/)** - Understand how it all works
+
+### I Want to Create Custom Feeds
+
+1. **[Web App](/web-application/getting-started)** - Start with the easy interface
+2. **[Ruby Gem](/ruby-gem/installation)** - For advanced customization
+3. **[Config Guide](/html2rss-configs/)** - Learn to write your own configs
 
-**Option 1: Browse Ready-Made Feeds (Easiest)**
-1. **[Feed Directory](/feed-directory/)** - See what's already available
-2. **Copy the RSS URL** and add it to your feed reader
+### I'm a Developer
+
+1. **[Ruby Gem Docs](/ruby-gem/)** - Full API reference
+2. **[Advanced Features](/ruby-gem/how-to/advanced-features/)** - Custom HTTP requests, etc.
+3. **[Contribute](/get-involved/contributing/)** - Help improve the project
+
+---
+
+## 🌟 What People Are Using html2rss For
+
+- **News & Blogs:** Follow your favorite writers without social media
+- **Job Hunting:** Track job postings from multiple company sites
+- **Product Updates:** Get notified when software you use gets updated
+- **Academic Research:** Follow new papers in your field
+- **Local News:** Stay updated on your neighborhood and city
+- **Hobby Communities:** Follow forums and communities you care about
+
+[Browse all examples in our Feed Directory →](/feed-directory/)
+
+---
 
-**Option 2: Create Your Own Feeds**
-1. **[Try html2rss-web](/web-application/getting-started)** - No technical knowledge required
-2. **[Install your own instance](/web-application/installation)** - For advanced users
+## 🔧 Common Issues?
 
-**New to RSS?** Start with the [Feed Directory](/feed-directory/) to see examples, then try [html2rss-web](/web-application/getting-started) to create your own feeds.
+**Feed not working?** Check our [troubleshooting guide](/support/troubleshooting)
+**Need help?** Join our [community discussions](https://github.com/orgs/html2rss/discussions)
+**Found a bug?** [Report it on GitHub](https://github.com/html2rss/html2rss/issues)

src/content/docs/ruby-gem/how-to/managing-feed-configs.mdx

@@ -12,7 +12,7 @@ You can define global settings that apply to all feeds, and then define individu
 ```yml
 # Global settings
 headers:
-  "User-Agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_1 like Mac OS X) AppleWebKit/603.1.30 (KHTML, like Gecko) Version/10.0 Mobile/14E304 Safari/602.1"
+  "User-Agent": "Mozilla/5.0 (compatible; html2rss/1.0; Mobile)"
   "Accept": "text/html"
 
 # Feed-specific settings

src/content/docs/ruby-gem/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: "Ruby Gem"
-description: "This section provides comprehensive documentation for the html2rss Ruby gem."
+description: "Complete documentation for the html2rss Ruby gem. Create custom RSS feeds programmatically with full control over scraping and feed generation."
 sidebar:
   label: "Overview"
 ---
@@ -9,7 +9,7 @@ This section provides comprehensive documentation for the `html2rss` Ruby gem.
 
 ## Getting Started
 
-If you are new to `html2rss`, we recommend starting with the [tutorials](/ruby-gem/tutorials).
+If you are getting started with `html2rss`, we recommend starting with the [tutorials](/ruby-gem/tutorials).
 
 ## Documentation Sections