Update README.md

Author: jacobdalamb

README.md

@@ -1,47 +1,58 @@
 # lychee Documentation
 
-This is the source code for the official documentation page of [lychee](https://github.com/lycheeverse/lychee/).
+This is the source code for the official documentation of [lychee](https://github.com/lycheeverse/lychee/), a fast, async link checker.
 
 [![Links](https://github.com/lycheeverse/lycheeverse.github.io/actions/workflows/check-links.yml/badge.svg)](https://github.com/lycheeverse/lycheeverse.github.io/actions/workflows/check-links.yml)
 [![Code Quality](https://github.com/lycheeverse/lycheeverse.github.io/actions/workflows/check-code-quality.yml/badge.svg)](https://github.com/lycheeverse/lycheeverse.github.io/actions/workflows/check-code-quality.yml)
 [![PR Links](https://github.com/lycheeverse/lycheeverse.github.io/actions/workflows/check-pr-links.yml/badge.svg)](https://github.com/lycheeverse/lycheeverse.github.io/actions/workflows/check-pr-links.yml)
 [![Deploy](https://github.com/lycheeverse/lycheeverse.github.io/actions/workflows/deploy.yml/badge.svg)](https://github.com/lycheeverse/lycheeverse.github.io/actions/workflows/deploy.yml)
 [![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
 
-## Getting Started
+## Quick Start
 
-To clone the repository, run
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) (v18+)
+- [pnpm](https://pnpm.io/) package manager
+
+### Development
 
 ```bash
+# Clone the repository
 git clone https://github.com/lycheeverse/lycheeverse.github.io.git
 ```
 
-## Installation
-
-To install the dependencies, run
-
 ```bash
+# Install dependencies
 pnpm install
 ```
 
-## Local Development
-
-To start the development server, run
-
 ```bash
+# Start local dev server
 pnpm dev
 ```
 
-## Raise an Issue
+## Contributing
+
+We welcome contributions! Here's how to help:
+
+### Report Issues
 
-Is something missing?
-Is something confusing?
-Is something wrong?
+Found a problem? Check if it's already been reported in our [issues](https://github.com/lycheeverse/lycheeverse.github.io/issues). If not, [create a new issue](https://github.com/lycheeverse/lycheeverse.github.io/issues/new/choose).
 
-[See if your issue has already been reported](https://github.com/lycheeverse/lycheeverse.github.io/issues), and if not, [create a new one](https://github.com/lycheeverse/lycheeverse.github.io/issues/new/choose).
+### Submit Changes
 
-## Make a Fix or Contribution
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes (fix typos, broken links, etc.)
+4. Submit a pull request
 
-Did you find a typo, a broken link, or another item with an obvious quick fix?
+## Project Structure
 
-If you can see what the problem is, and you know how to fix it, then you can make a PR (pull request) with the change and contribute to the docs repo yourself.
+```
+├── src/
+│   ├── assets/          # Images and static files
+│   └── content/         # Documentation pages (Markdown/MDX)
+├── astro.config.mjs     # Astro configuration
+└── package.json
+```