docs: improve Docker setup instructions

[Ndukuluz]

Clarified Docker setup steps to help new users get started more easily.

[vercel]

Someone is attempting to deploy a commit to the umami-software Team on Vercel.

A member of the Team first needs to authorize it.

[greptile-apps]

Greptile Overview

Greptile Summary

This PR attempts to improve Docker setup instructions by adding numbered steps and clarifying prerequisites. However, the changes introduce critical markdown syntax errors that will break the README rendering:

• Missing closing backticks for code blocks (line 92)
• Broken numbered list formatting with missing code block fences (line 93-94)
• Malformed bullet points and inconsistent indentation (lines 96-101)
• Orphaned code snippet without proper markdown fencing (line 103)

Additionally, the PR removes important Docker update instructions (docker compose pull and docker compose up --force-recreate -d) that were previously documented, leaving Docker users without guidance on how to update their installations.

The intent to improve documentation is good, but the execution has significant issues that need to be corrected before merging.

Confidence Score: 0/5

• This PR should not be merged due to critical markdown syntax errors that will break README rendering
• Score reflects multiple critical syntax errors in markdown formatting that will cause the README to render incorrectly on GitHub, making it unreadable for users. The broken code blocks and malformed lists will confuse new users rather than help them. Additionally, important update instructions were removed without replacement.
• README.md requires immediate attention to fix all markdown syntax errors and restore removed update instructions

Important Files Changed

File Analysis

Filename	Score	Overview
README.md	1/5	Docker setup section has critical markdown syntax errors that will break rendering and removed important update instructions

Sequence Diagram

sequenceDiagram
    participant User
    participant Docker
    participant DockerCompose
    participant PostgreSQL
    participant Umami

    User->>Docker: Install Docker & Docker Compose
    User->>User: Clone Umami repository
    User->>DockerCompose: docker compose up -d
    DockerCompose->>PostgreSQL: Start PostgreSQL container
    PostgreSQL-->>DockerCompose: Database ready
    DockerCompose->>Umami: Start Umami container
    Umami->>PostgreSQL: Connect to database
    PostgreSQL-->>Umami: Connection established
    Umami->>Umami: Initialize database tables
    Umami-->>DockerCompose: Application ready
    DockerCompose-->>User: Containers running
    User->>Umami: Access http://localhost:3000
    Umami-->>User: Login page (admin/umami)

Loading

[greptile-apps]

_{1 file reviewed, 4 comments}

_{Edit Code Review Agent Settings | Greptile}

[greptile-apps]

syntax: Missing closing backtick for code block

Suggested change

<details><summary>Prompt To Fix With AI</summary>

`````markdown
This is a comment left during a code review.
Path: README.md
Line: 92:92

Comment:
**syntax:** Missing closing backtick for code block

```suggestion

How can I resolve this? If you propose a fix, please make it concise.

[greptile-apps]

syntax: Missing opening code block fence and broken formatting

Suggested change

	3.**start the application and PostgreSQL database:
	docker compose up -d
	3. **Start the application and PostgreSQL database**:
	```bash
	docker compose up -d

<details><summary>Prompt To Fix With AI</summary>

`````markdown
This is a comment left during a code review.
Path: README.md
Line: 93:94

Comment:
**syntax:** Missing opening code block fence and broken formatting

```suggestion
3. **Start the application and PostgreSQL database**:
   ```bash
   docker compose up -d

How can I resolve this? If you propose a fix, please make it concise.

[greptile-apps]

syntax: Broken markdown formatting: missing code block formatting and inconsistent structure

Suggested change

	4. **- Access Umami in your browser:
	http://localhost:3000
	-
	- Default login credentials:
	- Username: admin
	- Password: umami
	4. **Access Umami in your browser**:
	- Navigate to: `http://localhost:3000`
	- Default login credentials:
	- Username: `admin`
	- Password: `umami`
	Alternatively, if you just want to pull the Docker image:
	```bash
	docker pull docker.umami.is/umami-software/umami:latest

<details><summary>Prompt To Fix With AI</summary>

`````markdown
This is a comment left during a code review.
Path: README.md
Line: 96:101

Comment:
**syntax:** Broken markdown formatting: missing code block formatting and inconsistent structure

```suggestion
4. **Access Umami in your browser**:
   - Navigate to: `http://localhost:3000`
   - Default login credentials:
     - Username: `admin`
     - Password: `umami`

Alternatively, if you just want to pull the Docker image:
```bash
docker pull docker.umami.is/umami-software/umami:latest

How can I resolve this? If you propose a fix, please make it concise.

[greptile-apps]

syntax: Orphaned code block without proper fencing - this will break markdown rendering

Suggested change

	docker pull docker.umami.is/umami-software/umami:latest
	---

Prompt To Fix With AI

This is a comment left during a code review.
Path: README.md
Line: 103:103

Comment:
**syntax:** Orphaned code block without proper fencing - this will break markdown rendering

```suggestion

---
```

How can I resolve this? If you propose a fix, please make it concise.