Docs: Update SEO and content (#1633)

* Docs: Update SEO and content

* Update website/src/content/docs/usage/cli.md

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Author: coliff

netlify.toml

@@ -26,12 +26,12 @@
 
 [[redirects]]
   from = "/docs/user-guide/list-rules"
-  to = "/list-rules"
+  to = "/rules/"
   status = 301
   force = true
 
 [[redirects]]
   from = "/docs/user-guide/usage/cli"
-  to = "/usage/cli"
+  to = "/usage/cli/"
   status = 301
   force = true

package.json

@@ -80,6 +80,6 @@
     "node": ">=20"
   },
   "volta": {
-    "node": "20.19.1"
+    "node": "20.19.2"
   }
 }

website/.htmlhintrc

@@ -12,6 +12,7 @@
   "button-type-require": false,
   "doctype-first": false,
   "doctype-html5": true,
+  "frame-title-require": true,
   "h1-require": true,
   "head-script-disabled": false,
   "href-abs-or-rel": false,
@@ -23,7 +24,8 @@
   "inline-style-disabled": false,
   "input-requires-label": false,
   "main-require": true,
-  "meta-description-require": true,
+  "meta-charset-require": true,
+  "meta-description-require": false,
   "meta-viewport-require": true,
   "script-disabled": false,
   "space-tab-mixed-disabled": false,

website/package-lock.json

@@ -4,6 +4,9 @@
   "private": true,
   "description": "The HTMLHint website - built with Astro Starlight",
   "homepage": "https://htmlhint.com",
+  "bugs": {
+    "url": "https://github.com/htmlhint/HTMLHint/issues"
+  },
   "funding": {
     "type": "opencollective",
     "url": "https://opencollective.com/htmlhint"
@@ -21,13 +24,13 @@
   },
   "dependencies": {
     "@astrojs/starlight": "^0.34.3",
-    "astro": "^5.8.2",
+    "astro": "^5.9.0",
     "sharp": "^0.34.2"
   },
   "engines": {
     "node": ">=20"
   },
   "volta": {
-    "node": "20.19.1"
+    "node": "20.19.2"
   }
 }

website/package.json

@@ -54,6 +54,7 @@ An example configuration file (with all rules disabled):
     "doctype-first": false,
     "doctype-html5": false,
     "empty-tag-not-self-closed": false,
+    "frame-title-require": false,
     "h1-require": false,
     "head-script-disabled": false,
     "href-abs-or-rel": false,
@@ -65,6 +66,7 @@ An example configuration file (with all rules disabled):
     "inline-style-disabled": false,
     "input-requires-label": false,
     "main-require": false,
+    "meta-charset-require": false,
     "meta-description-require": false,
     "meta-viewport-require": false,
     "script-disabled": false,

website/src/content/docs/configuration.md

@@ -16,11 +16,30 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
   </TabItem>
 </Tabs>
 
-2\. Create a `.htmlhintrc` configuration file in the root of your project:
+2\. Create a `.htmlhintrc` configuration file in the root of your project with `htmlhint --init`. This will create a file with default rules. You can customize it as needed. For example, you can use the following configuration to enforce some common best practices:
 
 ```json
 {
-  "attr-value-not-empty": false
+  "alt-require": true,
+  "attr-lowercase": true,
+  "attr-no-duplication": true,
+  "attr-value-double-quotes": true,
+  "button-type-require": true,
+  "doctype-first": true,
+  "doctype-html5": true,
+  "frame-title-require": true,
+  "h1-require": true,
+  "html-lang-require": true,
+  "id-unique": true,
+  "main-require": true,
+  "meta-charset-require": true,
+  "meta-description-require": true,
+  "meta-viewport-require": true,
+  "spec-char-escape": true,
+  "src-not-empty": true,
+  "tag-pair": true,
+  "tagname-lowercase": true,
+  "title-require": true
 }
 ```
 

website/src/content/docs/getting-started.mdx

@@ -1,6 +1,7 @@
 ---
 id: cli
 title: Command-Line Interface (CLI)
+description: Use HTMLHint from the command line to lint your HTML files. There are several options available to customize the behavior of the linter.
 ---
 
 You can use HTMLHint on the command-line. For example:

website/src/content/docs/usage/cli.md

@@ -1,6 +1,7 @@
 ---
 id: options
 title: Options
+description: Options for configuring HTMLHint config files, formatters, and more.
 ---
 
 ## `configFile`