docs: update readme and link checker

Author: thedaviddias

.github/workflows/link-checker.yml

@@ -23,7 +23,7 @@ jobs:
         id: lychee
         uses: lycheeverse/[email protected]
         with:
-          args: --config ./lychee.toml --verbose --no-progress README.md
+          args: --config ./lychee.toml --verbose --no-progress .
           fail: true
 
       - name: Create Issue From File

README.md

@@ -2,25 +2,11 @@
 
 UX Patterns for Developers is a free collection of UX patterns towards developers who want to understand how to build effective UI components accessible and usable.
 
+![Screenshot of the homepage ofUX Patterns for Devs](./public/img/ux-patterns-developers.webp)
+
 > [!NOTE]
 > This project is a work in progress. New content and updates should be expected regularly.
 
-## Getting Started
-
-To start the project locally, run:
-
-```bash
-pnpm run dev
-```
-
-### Generate new pattern
-
-This command will generate a new pattern template. Simply specify the language, the category and the name of the pattern starting with a capital letter.
-
-```bash
-pnpm run generate
-```
-
 ## 🧩 Patterns
 
 This is an non-exhaustive list of available and incoming patterns.
@@ -69,6 +55,22 @@ This is an non-exhaustive list of available and incoming patterns.
 - Notifications (coming soon)
 - Progress Indicator (coming soon)
 
+## Getting Started
+
+To start the project locally, run:
+
+```bash
+pnpm run dev
+```
+
+### Generate new pattern
+
+This command will generate a new pattern template. Simply specify the language, the category and the name of the pattern starting with a capital letter.
+
+```bash
+pnpm run generate
+```
+
 ## ✨ Contributors
 
 You are welcome to contribute to this project! Please read the [CONTRIBUTING.md](https://github.com/thedaviddias/ux-patterns-for-developers/blob/main/.github/CONTRIBUTING.md).

content/en/docs/forms/autocomplete.mdx

@@ -45,10 +45,6 @@ They combine the flexibility of text input with dropdown-style selection, provid
 
 ## Anatomy
 
-```mermaid
-
-```
-
 ### Component Structure
 
 1. **Container**
@@ -151,6 +147,10 @@ These design tokens follow the [Design Tokens Format](https://design-tokens.gith
 - [9 UX Best Practice Design Patterns for Autocomplete Suggestions](https://baymard.com/blog/autocomplete-design) by Baymard Institute
 - [Best Practices: Designing autosuggest experiences](https://uxmag.com/articles/best-practices-designing-autosuggest-experiences)
 
+## Documentation
+
+- [WAI-ARIA: Combobox Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/)
+
 ### Libraries
 
 - [Library 1]