docs: update and provide correct information

Author: gildesmarais

404.html

@@ -3,7 +3,18 @@
 layout: default
 ---
 
-<h1>404</h1>
+<h1>404 - Page Not Found</h1>
 
-<p><strong>Page not found :(</strong></p>
-<p>The requested page could not be found.</p>
+<p><strong>Sorry, the page you're looking for doesn't exist.</strong></p>
+
+<p>Here are some helpful links to get you back on track:</p>
+
+<ul>
+  <li><a href="{{ '/' | relative_url }}">Home</a> - Start from the beginning</li>
+  <li><a href="{{ '/web-application/getting-started' | relative_url }}">Getting Started</a> - Learn how to use html2rss</li>
+  <li><a href="{{ '/ruby-gem' | relative_url }}">Ruby Gem Documentation</a> - Developer resources</li>
+  <li><a href="{{ '/feed-directory' | relative_url }}">Feed Directory</a> - Browse available feeds</li>
+  <li><a href="{{ '/get-involved' | relative_url }}">Get Involved</a> - Join the community</li>
+</ul>
+
+<p>If you think this is an error, please <a href="https://github.com/html2rss/html2rss.github.io/issues">report it on GitHub</a>.</p>

about.md

@@ -31,4 +31,4 @@ For insights into our ongoing development, project roadmap, and how you can get
 
 `html2rss` is maintained by a dedicated group of volunteers and contributors from around the world. We are passionate about open source and committed to continuously improving the project.
 
-Want to join us? Check out our [Contributing Guide]({{ '/contributing' | relative_url }})!
+Want to join us? Check out our [Contributing Guide]({{ '/get-involved/contributing' | relative_url }})!

bin/data-update

@@ -16,9 +16,7 @@ def extract_default_parameters(parameters)
   return {} unless parameters.is_a?(Hash)
 
   parameters.each_with_object({}) do |(param_name, param_config), defaults|
-    if param_config.is_a?(Hash) && param_config['default']
-      defaults[param_name] = param_config['default']
-    end
+    defaults[param_name] = param_config['default'] if param_config.is_a?(Hash) && param_config['default']
   end
 end
 

get-involved/index.md

@@ -14,4 +14,4 @@ Engage with the `html2rss` project. Contribute and connect with the community.
 - [**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.
+- [**Contribute to html2rss**]({{ '/get-involved/contributing' | relative_url }}): Contribute code, documentation, or feed configurations.

html2rss-configs/index.md

@@ -108,19 +108,6 @@ selectors:
 
 ## Advanced Techniques
 
-### Handling Pagination
-
-To aggregate content from multiple pages, use the `pagination` option within the `items` selector.
-
-```yaml
-selectors:
-  items:
-    selector: ".post-listing .post"
-    pagination:
-      selector: ".pagination .next-page"
-      limit: 5 # Optional: sets the maximum number of pages to follow
-```
-
 ### Dynamic Feeds with Parameters
 
 Use the `parameters` block to create flexible configs. This is useful for feeds based on search terms, categories, or regions.
@@ -135,6 +122,15 @@ parameters:
 channel:
   url: "https://news.example.com/search?q={query}"
   title: "News results for '{query}'"
+
+selectors:
+  items:
+    selector: ".article"
+  title:
+    selector: "h2 a"
+  url:
+    selector: "h2 a"
+    extractor: "href"
 ```
 
 ---

ruby-gem/how-to/scraping-json.md

@@ -89,6 +89,8 @@ headers:
 channel:
   url: "http://domainname.tld/whatever.json"
 selectors:
+  items:
+    selector: "array > object"
   title:
     selector: "foo"
 ```

ruby-gem/installation.md

@@ -13,7 +13,7 @@ This guide will walk you through the process of installing html2rss on your syst
 
 ### Prerequisites
 
-- **Ruby:** html2rss is built with Ruby. Ensure you have Ruby installed (version 3.3 or higher recommended). You can check your Ruby version by running `ruby -v` in your terminal. If you don't have Ruby, visit [ruby-lang.org](https://www.ruby-lang.org/en/documentation/installation/) for installation instructions.
+- **Ruby:** html2rss is built with Ruby. Ensure you have Ruby installed (version 3.2 or higher required). You can check your Ruby version by running `ruby -v` in your terminal. If you don't have Ruby, visit [ruby-lang.org](https://www.ruby-lang.org/en/documentation/installation/) for installation instructions.
 - **Bundler (Recommended):** Bundler is a Ruby gem that manages your application's dependencies. It's highly recommended for a smooth installation. Install it with `gem install bundler`.
 
 ---
@@ -43,15 +43,13 @@ Then, run `bundle install` in your project directory.
 
 ---
 
-### Method 3: Docker (For Containerized Environments)
+### Method 3: GitHub Codespaces (For Cloud Development)
 
-For a more isolated and reproducible environment, you can use the official html2rss Docker image.
+For a quick start without local setup, you can develop html2rss directly in your browser using GitHub Codespaces:
 
-```bash
-docker pull html2rss/html2rss
-```
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://github.com/codespaces/new?repo=html2rss/html2rss)
 
-You can then run html2rss commands within a Docker container. Refer to the [Docker Hub page](https://hub.docker.com/r/html2rss/html2rss) for detailed usage.
+The Codespace comes pre-configured with Ruby 3.4, all dependencies, and VS Code extensions ready to go!
 
 ---
 

ruby-gem/reference/selectors.md

@@ -42,7 +42,7 @@ selectors:
 While you can define any named selector, only the following are used in the final RSS feed:
 
 | RSS 2.0 Tag   | `html2rss` Name |
-| ------------- | --------------- |
+| ------------- | --------------- | ------------------------------ |
 | `title`       | `title`         |
 | `description` | `description`   |
 | `link`        | `url`           |
@@ -51,17 +51,19 @@ While you can define any named selector, only the following are used in the fina
 | `guid`        | `guid`          |
 | `enclosure`   | `enclosure`     |
 | `pubDate`     | `published_at`  |
-| `comments`    | `comments`      |
+| `comments`    | `comments`      | ⚠️ _Not currently implemented_ |
 
 ## Selector Options
 
 Each selector can be configured with the following options:
 
-| Name           | Description                                      |
-| -------------- | ------------------------------------------------ |
-| `selector`     | The CSS selector for the target element.         |
-| `extractor`    | The extractor to use for this selector.          |
-| `post_process` | A list of post-processors to apply to the value. |
+| Name           | Description                                              |
+| -------------- | -------------------------------------------------------- |
+| `selector`     | The CSS selector for the target element.                 |
+| `extractor`    | The extractor to use for this selector.                  |
+| `attribute`    | The attribute name (required for `attribute` extractor). |
+| `static`       | The static value (required for `static` extractor).      |
+| `post_process` | A list of post-processors to apply to the value.         |
 
 ### Extractors
 
@@ -126,6 +128,10 @@ To add an enclosure (e.g., an image, audio, or video file) to an item, use the `
 
 ```yml
 selectors:
+  items:
+    selector: ".post"
+  title:
+    selector: "h2"
   enclosure:
     selector: "audio"
     extractor: "attribute"

ruby-gem/reference/stylesheets.md

@@ -17,7 +17,7 @@ You can add multiple stylesheets to your configuration:
 
 ```yaml
 stylesheets:
-  - href: "/path/to/style.xls"
+  - href: "/path/to/style.xsl"
     media: "all"
     type: "text/xsl"
   - href: "https://example.com/rss.css"