feat: update copy

Author: gildesmarais

README.md

@@ -1,3 +1,7 @@
 # html2rss.github.io
 
-🚧 WIP / Work in progress 🚧
+This repository hosts the documentation and website for `html2rss`, a tool for creating RSS feeds from any website.
+
+## Contributing
+
+Contributions are welcome! See our [Get Involved page](https://html2rss.github.io/get-involved) for details on discussions, reporting issues, and contributing.

get-involved/index.md

@@ -7,13 +7,9 @@ nav_order: 4
 
 # Get Involved
 
-Want to participate in the `html2rss` project? Explore the options below to engage with our community and contribute to the project's growth.
+Engage with the `html2rss` project. Contribute and connect with the community.
 
-- [**The Project Roadmap**]({{ 'https://github.com/orgs/html2rss/projects/3/views/1' }}): See what's being worked on, planned, and needs attention across all `html2rss` components.
-- [**Report Bugs & Discuss Features**]({{ '/get-involved/issues-and-features' | relative_url }}): Found a bug or have a new feature idea? Learn where to report and discuss them.
-- [**Join Community Discussions**]({{ '/get-involved/discussions' | relative_url }}): Connect with other users and contributors, ask questions, and share ideas.
-- [**Contribute to html2rss**]({{ '/contributing' | relative_url }}): Ready to contribute code, documentation, or feed configurations? Find detailed guides here.
-
----
-
-We appreciate your interest in `html2rss` and look forward to your involvement!
+- [**Project Roadmap**]({{ 'https://github.com/orgs/html2rss/projects/3/views/1' }}): View current work, plans, and priorities.
+- [**Report Bugs & Discuss Features**]({{ '/get-involved/issues-and-features' | relative_url }}): Report bugs or propose features.
+- [**Join Community Discussions**]({{ '/get-involved/discussions' | relative_url }}): Connect with users and contributors.
+- [**Contribute to html2rss**]({{ '/contributing' | relative_url }}): Contribute code, documentation, or feed configurations.

index.md

@@ -6,29 +6,28 @@ nav_order: 1
 
 # Create RSS Feeds for Any Website
 
-Tired of missing updates from websites that don't offer RSS feeds? `html2rss` is a powerful and flexible tool that lets you create your own RSS feeds for almost any website.
-
-[**🚀 Get Started with the Web App!**]({{ '/web-application/getting-started' | relative_url }})
+`html2rss` creates RSS feeds for any website.
+[**🚀 Get Started with the Web App**]({{ '/web-application/getting-started' | relative_url }})
 
 ---
 
 ## Key Features
 
-- **Automatic Feed Generation:** The `auto-source` scraper intelligently finds and extracts content from websites, so you can create feeds with minimal effort.
-- **Precise Content Extraction:** Use familiar CSS selectors to target the exact content you want to include in your feed.
-- **JavaScript Rendering:** Use a headless browser to render JavaScript-heavy websites and extract content that isn't available in the initial HTML.
-- **Open Source:** `html2rss` is free to use, modify, and contribute to.
+- **Automatic Feed Generation:** `auto_source` intelligently extracts content, simplifying feed creation.
+- **Precise Content Extraction:** Use CSS selectors for targeted content inclusion.
+- **JavaScript Rendering:** A headless browser renders JavaScript-heavy sites for comprehensive content extraction.
+- **Open Source:** `html2rss` is free to use, modify, and contribute.
 
 ---
 
 ## The html2rss Ecosystem
 
-The `html2rss` project is more than just a single tool. It's a collection of tools that work together to provide a complete RSS solution:
+The `html2rss` project offers a complete RSS solution through a collection of integrated tools:
 
-- **[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.
-- **[Feed Directory]({{ '/feed-directory' | relative_url }}):** A public listing of RSS feeds for websites of interest, powered by community-driven configurations.
+- **[html2rss-web]({{ '/web-application' | relative_url }}):** User-friendly web application to create, manage, and share RSS feeds. Recommended starting point.
+- **[html2rss (Ruby Gem)]({{ '/ruby-gem' | relative_url }}):** Core library and command-line interface for developers.
+- **[Feed Directory]({{ '/feed-directory' | relative_url }}):** Public listing of community-driven RSS feed configurations.
 
 ---
 
-Want to engage with the `html2rss` community or contribute to the project? Visit our [Get Involved]({{ '/get-involved' | relative_url }}) page for details on discussions, reporting issues, and contributing.
+Engage with the `html2rss` community or contribute. Visit our [Get Involved]({{ '/get-involved' | relative_url }}) page.

ruby-gem/index.md

@@ -7,15 +7,11 @@ has_children: true
 
 # 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.
-
-If you are looking for the easiest way to get started with `html2rss`, we recommend using the [web application]({{ '/web-application' | relative_url }}).
-
-This documentation is for developers who want to use the `html2rss` gem directly.
+This section documents the `html2rss` Ruby gem, the core library for `html2rss-web`. This documentation targets developers using the gem directly. For an easier start, use the [web application]({{ '/web-application' | relative_url }}).
 
 ## Getting Started
 
-We recommend starting with the [Installation guide]({{ '/ruby-gem/tutorials/installation' | relative_url }}) to set up `html2rss` on your system. Once installed, proceed to our step-by-step guide to [creating your first feed]({{ '/ruby-gem/tutorials/your-first-feed' | relative_url }}).
+Start with the [Installation guide]({{ '/ruby-gem/tutorials/installation' | relative_url }}). Then, create your [first feed]({{ '/ruby-gem/tutorials/your-first-feed' | relative_url }}).
 
 ## Documentation Sections
 
@@ -25,9 +21,9 @@ We recommend starting with the [Installation guide]({{ '/ruby-gem/tutorials/inst
 
 ## Advanced Topics
 
-- [**Handling Dynamic Content and JavaScript**]({{ '/ruby-gem/how-to/handling-dynamic-content' | relative_url }}): Learn how to handle JavaScript-heavy websites.
-- [**Customizing HTTP Requests**]({{ '/ruby-gem/how-to/custom-http-requests' | relative_url }}): How to send custom HTTP headers.
+- [**Handling Dynamic Content and JavaScript**]({{ '/ruby-gem/how-to/handling-dynamic-content' | relative_url }}): Process JavaScript-heavy websites.
+- [**Customizing HTTP Requests**]({{ '/ruby-gem/how-to/custom-http-requests' | relative_url }}): Send custom HTTP headers.
 - [**Dynamic Parameters in URLs and Headers**]({{ '/ruby-gem/how-to/dynamic-parameters' | relative_url }}): Use dynamic parameters in URLs and headers.
-- [**Advanced Content Extraction with Selectors**]({{ '/ruby-gem/how-to/advanced-content-extraction' | relative_url }}): Precise content extraction techniques.
-- [**Styling Your RSS Feed**]({{ '/ruby-gem/how-to/styling-rss-feed' | relative_url }}): Add stylesheets to your RSS feed.
-- [**Debugging Your Configuration**]({{ '/support/troubleshooting' | relative_url }}): Debug your feed configuration effectively.
+- [**Advanced Content Extraction with Selectors**]({{ '/ruby-gem/how-to/advanced-content-extraction' | relative_url }}): Advanced content extraction.
+- [**Styling Your RSS Feed**]({{ '/ruby-gem/how-to/styling-rss-feed' | relative_url }}): Add stylesheets to RSS feeds.
+- [**Debugging Your Configuration**]({{ '/support/troubleshooting' | relative_url }}): Debug feed configurations.

web-application/index.md

@@ -7,17 +7,17 @@ has_children: true
 
 # html2rss-web
 
-This web application scrapes websites to build and deliver RSS 2.0 feeds. It's a powerful tool for creating custom RSS feeds for any website.
+This web application scrapes websites to build and deliver RSS 2.0 feeds. It is a powerful tool for creating custom RSS feeds.
 
 ## Get Started
 
-Ready to dive in? Our **[Getting Started guide]({{ '/web-application/getting-started' | relative_url }})** will walk you through the essential first steps, from understanding the application to installing your own instance.
+Our **[Getting Started guide]({{ '/web-application/getting-started' | relative_url }})** covers essential first steps, from understanding the application to installing your own instance.
 
 ## Key Features
 
-- **Stable URLs:** Provides stable URLs for feeds generated by automatic sourcing.
-- **Custom Feeds:** Create your own custom feeds.
-- **Feed Directory:** Comes with plenty of [feeds](https://github.com/html2rss/html2rss-configs) out of the box.
-- **Caching:** Handles request caching and sets caching-related HTTP headers.
+- **Stable URLs:** Provides stable URLs for automatically sourced feeds.
+- **Custom Feeds:** Create custom feeds.
+- **Feed Directory:** Includes many [feeds](https://github.com/html2rss/html2rss-configs) out of the box.
+- **Caching:** Handles request caching and sets HTTP headers.
 
 The functionality of scraping websites and building the RSS feeds is provided by the Ruby gem [`html2rss`](https://github.com/html2rss/html2rss).

web-application/installation.md

@@ -90,5 +90,5 @@ Congratulations! Your personal `html2rss-web` instance is now running. You can a
 
 ## Next Steps
 
-- Now that your instance is running, head over to the **[Tutorials]({{ '/web-application/tutorials' | relative_url }})** to learn how to create your first feed.
+- Now that your instance is running, head over to the **[How-To Guides]({{ '/web-application/how-to/' | relative_url }})** to learn how to create your first feed. We recommend starting with the [Creating Custom Feeds]({{ '/web-application/how-to/creating-custom-feeds' | relative_url }}) guide.
 - For a more secure setup, consider putting your instance behind a reverse proxy. You can find more information in the [deployment guide]({{ '/web-application/how-to/deployment' | relative_url }}).