[PR #928] [CLOSED] Redesign homepage and getting started with seo/geo improvements, wayfinding and brand voice #935

New issue

Closed

opened 2026-10-18 14:15:49 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-18 14:15:49 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/928
Author: @peetuhr
Created: 12/29/2025
Status: ❌ Closed

Base: main ← Head: docs-home-change

📝 Commits (6)

69a034d Enhance documentation with home clarity, seo/geo recommendations, refined quick start and installation methods, including clearer paths for diverse setups. Added sections on getting the most out of OWUI.
2f361aa Small update to the "Getting Started" section. Changed the "Reference" header to "Explore What's Possible" and added links to key features.
3a2a6da Add link to "Getting Started" section.
eab6ce2 Revise introduction and quick start documentation for clarity and engagement. Updated the description of Open WebUI to clarify OpenAI API/function capablities.
d44def9 Merge branch 'open-webui:main' into docs-home-change
17aa46b Merge branch 'docs-home-change' of https://github.com/peetuhr/owui-docs into docs-home-change

📊 Changes

3 files changed (+383 additions, -265 deletions)

View changed files

📝 docs/getting-started/index.md (+63 -6)
📝 docs/getting-started/quick-start/index.mdx (+204 -121)
📝 docs/intro.mdx (+116 -138)

📄 Description

Summary

Overhaul of the homepage and Getting Started/Quick Start section to improve user wayfinding, apply consistent brand voice, and lay groundwork for future visual enhancements.

Changes

Homepage

Rewrote hero section with clear value proposition.
Added wayfinding for different deployment methods
Added "What You Can Do" section highlighting key capabilities
Elevated privacy/sovereignty messaging throughout
Added "Free to Use. Built in Public." section combining mission + community
Refined Enterprise callout with link to full Enterprise section
Removed redundant content; added forward-linking to many relevant docs

Getting Started

Added intent-based descriptions for Quick Start, Advanced Topics, and Updating
Added "What's inside" previews for each section
Elevated Environment Variables and API Endpoints to Reference section
Applied brand voice: encouraging, practical, momentum-building

Quick Start

Added "Choose Your Path" table with time estimates and "Best for" guidance
Split info boxes: Admin/Roles separate from Privacy/Data Security
Added "Connect Your Models" section with paths to Ollama, OpenAI, Functions
Added "Get the Most Out of Your Setup" section (Tailscale, PWA, users)
Added "Explore What's Possible" forward-links to features
Condensed tab labels for readability (Compose, Desktop, Swarm, etc.)

Voice & Tone

Applied brand voice guidelines throughout:
- Direct over decorative. Warm accents.
- Honest about complexity
- Ownership language ("your data," "your rules")
- Privacy as a feature, (a luxury, even)

Future Work

Custom card components for visual polish (content-first approach for now)
Create additional pages (Tailscale tutorial, PWA setup, Voice assistant setup.)

Homepage:

Getting Started:
getting-started
Quick Start:
quick-start

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/docs/pull/928 **Author:** [@peetuhr](https://github.com/peetuhr) **Created:** 12/29/2025 **Status:** ❌ Closed **Base:** `main` ← **Head:** `docs-home-change` --- ### 📝 Commits (6) - [`69a034d`](https://github.com/open-webui/docs/commit/69a034d916056f2cf5abf9f2ab822cc097ca6c4e) Enhance documentation with home clarity, seo/geo recommendations, refined quick start and installation methods, including clearer paths for diverse setups. Added sections on getting the most out of OWUI. - [`2f361aa`](https://github.com/open-webui/docs/commit/2f361aa0db1c29918a71021356291b1fa4d4c0bb) Small update to the "Getting Started" section. Changed the "Reference" header to "Explore What's Possible" and added links to key features. - [`3a2a6da`](https://github.com/open-webui/docs/commit/3a2a6da51e3d55f8a7a71079973970af179f7da9) Add link to "Getting Started" section. - [`eab6ce2`](https://github.com/open-webui/docs/commit/eab6ce29af24e979d5918253d9bcd352085b0047) Revise introduction and quick start documentation for clarity and engagement. Updated the description of Open WebUI to clarify OpenAI API/function capablities. - [`d44def9`](https://github.com/open-webui/docs/commit/d44def9473b3812f89790469bb4edf29e576d782) Merge branch 'open-webui:main' into docs-home-change - [`17aa46b`](https://github.com/open-webui/docs/commit/17aa46bdfb2a12356f76cd7736ae094c0f7fcb15) Merge branch 'docs-home-change' of https://github.com/peetuhr/owui-docs into docs-home-change ### 📊 Changes **3 files changed** (+383 additions, -265 deletions) <details> <summary>View changed files</summary> 📝 `docs/getting-started/index.md` (+63 -6) 📝 `docs/getting-started/quick-start/index.mdx` (+204 -121) 📝 `docs/intro.mdx` (+116 -138) </details> ### 📄 Description ## Summary Overhaul of the homepage and Getting Started/Quick Start section to improve user wayfinding, apply consistent brand voice, and lay groundwork for future visual enhancements. ## Changes ### Homepage - Rewrote hero section with clear value proposition. - Added wayfinding for different deployment methods - Added "What You Can Do" section highlighting key capabilities - Elevated privacy/sovereignty messaging throughout - Added "Free to Use. Built in Public." section combining mission + community - Refined Enterprise callout with link to full Enterprise section - Removed redundant content; added forward-linking to many relevant docs ### Getting Started - Added intent-based descriptions for Quick Start, Advanced Topics, and Updating - Added "What's inside" previews for each section - Elevated Environment Variables and API Endpoints to Reference section - Applied brand voice: encouraging, practical, momentum-building ### Quick Start - Added "Choose Your Path" table with time estimates and "Best for" guidance - Split info boxes: Admin/Roles separate from Privacy/Data Security - Added "Connect Your Models" section with paths to Ollama, OpenAI, Functions - Added "Get the Most Out of Your Setup" section (Tailscale, PWA, users) - Added "Explore What's Possible" forward-links to features - Condensed tab labels for readability (Compose, Desktop, Swarm, etc.) ### Voice & Tone - Applied brand voice guidelines throughout: - Direct over decorative. Warm accents. - Honest about complexity - Ownership language ("your data," "your rules") - Privacy as a feature, (a luxury, even) ## Future Work - Custom card components for visual polish (content-first approach for now) - Create additional pages (Tailscale tutorial, PWA setup, Voice assistant setup.) Homepage: <img width="1377" height="5927" alt="homepage" src="https://github.com/user-attachments/assets/7e8809bd-a623-4a16-9abf-cc879818927b" /> Getting Started: <img width="1377" height="2976" alt="getting-started" src="https://github.com/user-attachments/assets/4aae812d-080b-49d9-a39f-490691e9bab5" /> Quick Start: <img width="1377" height="7652" alt="quick-start" src="https://github.com/user-attachments/assets/c86f955f-7b73-40b1-b7ae-86c0470506fc" /> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:15:49 +00:00