refactor: update documentation for clarity and consistency

Author: gildesmarais

feed-directory/index.html

@@ -87,35 +87,32 @@ <h3 class="card-title mb-0 text-mono fs-5">
         {%- endif -%}
       </div>
       <div class="card-body">
-        <details>
-          <summary>Details</summary>
-          <dl>
-            {%- if config.channel.url -%}
-            <dt>URL to scrape</dt>
-            <dd>
-              {%- if config.valid_channel_url -%}
-              <a
-                href="{{ config.channel.url }}"
-                class="config__url"
-                target="_blank"
-                rel="noopener noreferrer"
-                >{{ config.channel.url }}</a
-              >
-              {%- else -%}
-              <span class="config__url"
-                >{{ config.channel.url | xml_escape }}</span
-              >
-              {%- endif -%}
-            </dd>
-            {%- endif -%} {%- if config.channel.time_zone -%}
-            <dt>Time zone</dt>
-            <dd>{{ config.channel.time_zone }}</dd>
-            {%- endif -%} {%- if config.channel.language -%}
-            <dt>Language</dt>
-            <dd>{{ config.channel.language }}</dd>
+        <dl>
+          {%- if config.channel.url -%}
+          <dt>URL to scrape</dt>
+          <dd>
+            {%- if config.valid_channel_url -%}
+            <a
+              href="{{ config.channel.url }}"
+              class="config__url"
+              target="_blank"
+              rel="noopener noreferrer"
+              >{{ config.channel.url }}</a
+            >
+            {%- else -%}
+            <span class="config__url"
+              >{{ config.channel.url | xml_escape }}</span
+            >
             {%- endif -%}
-          </dl>
-        </details>
+          </dd>
+          {%- endif -%} {%- if config.channel.time_zone -%}
+          <dt>Time zone</dt>
+          <dd>{{ config.channel.time_zone }}</dd>
+          {%- endif -%} {%- if config.channel.language -%}
+          <dt>Language</dt>
+          <dd>{{ config.channel.language }}</dd>
+          {%- endif -%}
+        </dl>
 
         {%- if config.valid_channel_url -%}
         <div class="mt-4 d-flex-justify-content-between">

index.md

@@ -27,7 +27,7 @@ The `html2rss` project is more than just a single tool. It's a collection of too
 
 - **[html2rss-web]({{ '/web-application' | relative_url }}):** A user-friendly web application that makes it easy to create, manage, and share RSS feeds. This is the recommended starting point for most users.
 - **[html2rss (Ruby Gem)]({{ '/ruby-gem' | relative_url }}):** The core library that powers the web application. It provides a powerful and flexible command-line interface for creating custom RSS feeds.
-- **[html2rss-configs](https://github.com/html2rss/html2rss-configs):** A community-driven repository of pre-built feed configurations for popular websites, so you can get started quickly.
+- **[Feed Directory]({{ '/feed-directory' | relative_url }}):** A public listing of RSS feeds for websites of interest, powered by community-driven configurations.
 
 ---
 

ruby-gem/index.md

@@ -6,7 +6,7 @@ has_children: true
 permalink: /ruby-gem
 ---
 
-# The html2rss Ruby Gem
+# The html2rss Ruby Gem ([GitHub Repo](https://github.com/html2rss/html2rss))
 
 This section provides detailed documentation for the `html2rss` Ruby gem. The gem is the core library that powers the `html2rss-web` application.
 

ruby-gem/tutorials/installation.md

@@ -3,6 +3,7 @@ layout: default
 title: Installation
 nav_order: 2
 parent: Tutorials
+grand_parent: Ruby Gem
 permalink: /ruby-gem/tutorials/installation
 ---
 

ruby-gem/tutorials/your-first-feed.md

@@ -3,6 +3,7 @@ layout: default
 title: Your First Feed
 nav_order: 3
 parent: Tutorials
+grand_parent: Ruby Gem
 permalink: /ruby-gem/tutorials/your-first-feed
 ---
 

web-application/index.md

@@ -8,7 +8,7 @@ permalink: /web-application
 
 # html2rss-web
 
-This web application scrapes websites to build and deliver RSS 2.0 feeds.
+This web application scrapes websites to build and deliver RSS 2.0 feeds. ([GitHub Repo](https://github.com/html2rss/html2rss-web))
 
 ## Features
 

web-application/tutorials/index.md

@@ -1,12 +1,12 @@
 ---
 layout: default
-title: Tutorials
+title: Getting Started
 nav_order: 1
 permalink: /web-application/tutorials
 parent: Web Application
 ---
 
-# Tutorials: Getting Started with html2rss-web
+# Getting Started with html2rss-web
 
 In this guide, you'll launch the `html2rss-web` application on your local machine. By the end, you'll have a running instance and your first live RSS feed.