Improve docs web site

docs/getting-started.md

@@ -2,12 +2,27 @@
 
 Welcome to cpp-linter! This guide will help you integrate C/C++ linting into your workflow quickly and efficiently.
 
+## What is cpp-linter?
+
+cpp-linter connects the standard LLVM linting tools, `clang-format` and `clang-tidy`, to the places where C/C++ projects need checks: pull requests, pre-commit hooks, local scripts, and CI jobs.
+
+- `clang-format` checks formatting against a named style or your `.clang-format` file.
+- `clang-tidy` runs static-analysis and modernization checks, usually configured by `.clang-tidy`.
+- cpp-linter wraps those tools into integrations with consistent defaults, reporting, and failure controls.
+
 ## Choose Your Integration
 
 <!-- markdownlint-disable MD033 -->
 
 Select the method that best fits your development workflow:
 
+| Use case | Recommended entry point |
+| --- | --- |
+| GitHub pull request checks | [cpp-linter-action](https://cpp-linter.github.io/cpp-linter-action/) |
+| Local checks before commits | [cpp-linter-hooks](https://github.com/cpp-linter/cpp-linter-hooks) |
+| Custom scripts or CI jobs | [cpp-linter CLI](https://cpp-linter.github.io/cpp-linter/) |
+
+
 <div class="grid cards" markdown>
 
 - :material-github: **GitHub Actions**

docs/index.md

@@ -177,20 +177,12 @@ title: C/C++ Linting
     ```yaml
     repos:
       - repo: https://github.com/cpp-linter/cpp-linter-hooks
-        rev: v1.2.0  # Use the tag or commit you want
+        rev: v1.4.0  # Use the tag or commit you want
         hooks:
-        - id: clang-format
+          - id: clang-format
             args: [--style=Google] # Other coding style: LLVM, GNU, Chromium, Microsoft, Mozilla, WebKit.
-        - id: clang-tidy
-            args:
-              - --checks='boost-*
-              - bugprone-*
-              - performance-*
-              - readability-*
-              - portability-*
-              - modernize-*
-              - clang-analyzer-*
-              - cppcoreguidelines-*'
+          - id: clang-tidy
+            args: [--checks=-*,bugprone-*,performance-*,readability-*]
     ```
 
 === "Command Line"

mkdocs.yml

@@ -66,6 +66,7 @@ markdown_extensions:
       emoji_generator: !!python/name:material.extensions.emoji.to_svg
 
 plugins:
+  - search
   - blog
 
 extra_css: