Improve doc

Author: Ndpnt

content/terms/explanation/filters.md

@@ -13,13 +13,9 @@ Filters are necessary when standard CSS selectors and range selectors cannot ade
 
 Use filters when:
 
-- **CSS selectors are insufficient**: When noise appears within content that can't be targeted with selectors or [range selectors]({{< relref "terms/explanation/range-selectors" >}}) with the [`select`]({{< relref "terms/reference/declaration/#ref-select" >}}) and [`remove`]({{< relref "terms/reference/declaration/#ref-remove" >}}) properties.
-- **Content is dynamically generated**: When elements change on each page load, such as:
-  - Tracking parameters in URLs (e.g., `utm_source`, `utm_medium`)
-  - Dynamic elements with changing classes or IDs
-- **Complex tasks are needed**: When content transformation is needed such as:
-  - Converting images to base64 to store them in the terms version.
-  - Converting date-based content to a more stable format (e.g., "Updated X days ago" to "Last updated on YYYY-MM-DD")
+- **CSS selectors are insufficient**, for example when noise appears within content that can't be targeted with selectors or [range selectors]({{< relref "terms/explanation/range-selectors" >}}) with the [`select`]({{< relref "terms/reference/declaration/#ref-select" >}}) and [`remove`]({{< relref "terms/reference/declaration/#ref-remove" >}}) properties.
+- **Content is dynamically generated**, for example when elements change on each page load with tracking parameters in URLs (like `utm_source`, `utm_medium`) or dynamic elements with changing classes or IDs.
+- **Complex tasks are needed**, for example when content transformation is required such as converting images to base64 to store them in the terms version or converting date-based content to a more stable format (like "Updated X days ago" to "Last updated on YYYY-MM-DD").
 
 ## How filters work
 
@@ -29,16 +25,16 @@ Filters are JavaScript functions that receive a JSDOM document instance and can
 
 When designing filters, follow these core principles:
 
-- **Be specific**: Target only the noise you want to remove. Avoid broad selectors that might accidentally remove important content. 
+- **Be specific**: target only the noise you want to remove. Avoid broad selectors that might accidentally remove important content.
 
   > For example, if your filter converts relative dates to absolute dates, use `.metadata time` not `time` which might also affect important effective dates within the terms content.
 
-- **Be idempotent**: Filters should produce the same result even if run multiple times on their own output. This ensures consistency and prevents unexpected behavior.
+- **Be idempotent**: filters should produce the same result even if run multiple times on their own output. This ensures consistency and prevents unexpected behavior.
 
   > For example, if your filter adds section numbers like "1." to headings, check if numbers already exist to prevent "1. Privacy Policy" from becoming "1. 1. Privacy Policy" on repeated runs.
 
-- **Be efficient**: Use efficient DOM queries and avoid unnecessary operations. Process only the elements you need to modify.  
+- **Be efficient**: use efficient DOM queries and avoid unnecessary operations. Process only the elements you need to modify.
 
   > For example, if your filter updates timestamp elements with a specific class, use `document.querySelector('.timestamp')` instead of `document.querySelectorAll('*')` followed by filtering for timestamp elements.
 
-- **Be safe**: Filters should not accidentally remove important content. The generated version should always be checked after adding a filter to ensure it still contains the whole terms content.
+- **Be safe**: filters should not accidentally remove important content. The generated version should always be checked after adding a filter to ensure it still contains the whole terms content.

content/terms/reference/filters.md

@@ -175,7 +175,7 @@ Result:
 import fetch from 'isomorphic-fetch';
 
 export async function convertImagesToBase64(document, selector, documentDeclaration) {
-  const images = Array.from(document.querySelectorAll(`selector`));
+  const images = Array.from(document.querySelectorAll(selector));
 
   return Promise.all(images.map(async ({ src }, index) => {
     if (src.startsWith('data:')) {