waveterm/docs
Copilot a23bbc00dc
Remove embedded docsite, always use live docs.waveterm.dev (#2503)
Removes the embedded Docusaurus build from the application. The help
view now always loads from https://docs.waveterm.dev/ instead of serving
a locally bundled copy. This eliminates package size constraints on
documentation content (e.g., videos) and removes unnecessary
build/packaging overhead.

**Backend changes:**
- Deleted `pkg/docsite` package entirely
- Removed docsite handler from `pkg/web/web.go`
- Simplified `emain/docsite.ts` to return constant URL instead of
probing for embedded docs

**Frontend changes:**
- Removed embedded URL translation logic from `helpview.tsx`
- Homepage URL now uses constant instead of IPC call

**Build configuration:**
- Removed `docsite:build:embedded` task and all references
- Removed `dist/docsite/**/*` from electron-builder asarUnpack
- Removed `build-embedded` script from docs package.json

Net result: -141 lines, +9 lines across 8 files.

<!-- START COPILOT CODING AGENT SUFFIX -->



<details>

<summary>Original prompt</summary>

> right now we build a docusaurus project to run both the online docs at
docs.waveterm.dev AND to embed into the application. but this limits
what we can show in the docs (especially large things like videos etc.)
> 
> the internal docs already fall back to the website when it cannot find
the embedded docs.
> 
> i'd like to update the build and packaging etc to no longer build the
embedded doc site. i'd also like to have the "help" view always render
the live doc site at https://docs.waveterm.dev.


</details>



<!-- START COPILOT CODING AGENT TIPS -->
---

💡 You can make Copilot smarter by setting up custom instructions,
customizing its development environment and configuring Model Context
Protocol (MCP) servers. Learn more [Copilot coding agent
tips](https://gh.io/copilot-coding-agent-tips) in the docs.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: sawka <2722291+sawka@users.noreply.github.com>
2025-11-04 14:09:08 -08:00
..
docs v0.12.2 release notes, onboarding flow (#2518) 2025-11-04 14:02:35 -08:00
src fix linting errors, fix electron vite popping up index.html, docs typescript errors, etc. (#2265) 2025-08-19 15:50:25 -07:00
static Add sharp-solid font to docsite (#1813) 2025-01-23 12:23:24 -08:00
.editorconfig Move docsite to main repo (#1204) 2024-11-06 10:45:21 -08:00
.gitignore Move docsite to main repo (#1204) 2024-11-06 10:45:21 -08:00
.prettierignore Move docsite to main repo (#1204) 2024-11-06 10:45:21 -08:00
.remarkrc Move docsite to main repo (#1204) 2024-11-06 10:45:21 -08:00
babel.config.js Move docsite to main repo (#1204) 2024-11-06 10:45:21 -08:00
docusaurus.config.ts Add code highlighting to docsite (#1866) 2025-01-28 19:38:43 -08:00
eslint.config.js Move docsite to main repo (#1204) 2024-11-06 10:45:21 -08:00
package.json Remove embedded docsite, always use live docs.waveterm.dev (#2503) 2025-11-04 14:09:08 -08:00
prettier.config.cjs Move docsite to main repo (#1204) 2024-11-06 10:45:21 -08:00
README.md switch from yarn to npm (#2347) 2025-09-12 15:36:03 -07:00
tsconfig.json Move docsite to main repo (#1204) 2024-11-06 10:45:21 -08:00

Wave Terminal Documentation

This is the home for Wave Terminal's documentation site. This README is specifically about building and contributing to the docs site. If you are looking for the actual hosted docs, go here -- https://docs.waveterm.dev

Installation

Our docs are built using Docusaurus, a modern static website generator.

Local Development

task docsite

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Build

task docsite:build:<embedded,public>

This command generates static content into the build directory and can be served using any static contents hosting service.

Deployment

Deployments are handled automatically by the Docsite and Storybook CI/CD workflow