docs(contributing): fix troubleshooting accordion code block formatting (#3269)

This commit is contained in:
Santhi Prakash
2026-07-27 13:12:44 +02:00
committed by GitHub
parent 689e7e24d4
commit e6b4733c5f
+27 -8
View File
@@ -270,23 +270,42 @@ pnpm run typecheck
<AccordionGroup> <AccordionGroup>
<Accordion title="Port 3000 or 3001 is already in use"> <Accordion title="Port 3000 or 3001 is already in use">
The Vite web server uses `PORT` (default `3000`), and the Hono server uses `SERVER_PORT` (default `3001`). The Vite web server uses `PORT` (default `3000`), and the Hono server uses `SERVER_PORT` (default `3001`).
Either stop the conflicting process or choose alternate ports: ```bash PORT=3002 SERVER_PORT=3003 pnpm dev ``` Either stop the conflicting process or choose alternate ports:
```bash
PORT=3002 SERVER_PORT=3003 pnpm dev
```
</Accordion> </Accordion>
<Accordion title="Database connection refused"> <Accordion title="Database connection refused">
Ensure Docker containers are running: ```bash docker compose -f compose.dev.yml ps docker compose -f compose.dev.yml Ensure Docker containers are running:
up -d ``` Check that PostgreSQL is healthy and accessible on port 5432. ```bash
docker compose -f compose.dev.yml ps
docker compose -f compose.dev.yml up -d
```
Check that PostgreSQL is healthy and accessible on port 5432.
</Accordion> </Accordion>
<Accordion title="S3/Storage errors"> <Accordion title="S3/Storage errors">
Verify SeaweedFS is running and the bucket exists: ```bash docker compose -f compose.dev.yml logs seaweedfs docker Verify SeaweedFS is running and the bucket exists:
compose -f compose.dev.yml logs seaweedfs_create_bucket ``` If the bucket wasn't created, restart the bucket ```bash
creation service: ```bash docker compose -f compose.dev.yml restart seaweedfs_create_bucket ``` docker compose -f compose.dev.yml logs seaweedfs
docker compose -f compose.dev.yml logs seaweedfs_create_bucket
```
If the bucket wasn't created, restart the bucket creation service:
```bash
docker compose -f compose.dev.yml restart seaweedfs_create_bucket
```
</Accordion> </Accordion>
<Accordion title="Type errors after pulling changes"> <Accordion title="Type errors after pulling changes">
The route tree may need regeneration. Run the dev server which auto-generates routes: ```bash pnpm run dev ``` Or The route tree may need regeneration. Run the dev server which auto-generates routes:
run type checking to see specific errors: ```bash pnpm run typecheck ``` ```bash
pnpm run dev
```
Or run type checking to see specific errors:
```bash
pnpm run typecheck
```
</Accordion> </Accordion>
</AccordionGroup> </AccordionGroup>