Add a Download & Install page to Getting Started#442
Open
jetm wants to merge 2 commits into
Open
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a single “Download & Install” entry point under Getting Started (covering both Avocado Desktop and the CLI) and publishes the previously-drafted Node.js dashboard portability field note, alongside a couple of small doc/UI polish fixes.
Changes:
- Add a new Getting Started “Download & Install” doc covering macOS Desktop (DMG + Homebrew cask) and the CLI one-liner, with a link to the full CLI install guide.
- Wire the new doc into the Guides sidebar.
- Publish the Node.js dashboard portability field note (remove draft gating) and apply minor copy/link cleanup in related docs/components.
Reviewed changes
Copilot reviewed 5 out of 6 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
| src/src/components/TestStatus/index.jsx | Adjusts the reference link to use href for external URLs. |
| src/sidebars-guides.js | Adds the new Getting Started page to the Guides sidebar. |
| src/field-notes/2026-07-01-nodejs-dashboard-portability.mdx | Publishes the portability field note by removing draft: true / placeholder text. |
| src/field-notes/2026-06-22-fastest-path-ai-vision-nvidia.mdx | Minor TL;DR copy edit (typo/wording cleanup). |
| src/docusaurus.config.js | Minor blog description whitespace cleanup. |
| src/docs-guides/getting-started/download.md | New “Download & Install” page documenting Desktop + CLI install paths. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
The docs covered installing the Avocado CLI but never the Avocado Desktop app, and no single page pointed a new user at both. Add a Download & Install page under Getting Started covering the macOS desktop DMG, the Homebrew cask, the minimum macOS version, and the Windows/Linux "coming soon" state, alongside the CLI curl one-liner. It links to the existing CLI installation guide for the full platform matrix rather than duplicating it, and wires the page into the Getting Started sidebar.
jetm
force-pushed
the
jtia/field-notes-followup
branch
from
6650250 to
b1a39d5
Compare
jetm
changed the title
The bare `avocado-desktop` cask name does not resolve without the tap already added. Use the fully-qualified `avocado-linux/tap/avocado-desktop` so the documented command works in one step.
Comment on lines
+22
to
+25
| Download the latest release directly: | ||
|
|
||
| - [Download Avocado Desktop for macOS](https://repo.avocadolinux.org/releases/desktop/stable/Avocado-0.4.4.dmg) | ||
|
|
Comment on lines
+28
to
+30
| ```bash | ||
| brew install --cask avocado-linux/tap/avocado-desktop | ||
| ``` |
Contributor
Author
|
@lee-reinhardt mind giving this a review? It's the docs half of the Download page: a Getting Started "Download & Install" page covering the macOS DMG, the tapped Homebrew cask, and the CLI curl one-liner. Pinned to 0.4.4 for now per our Slack thread; I'll bump to 1.0 once that's the stable build. This is the docs side Bill was asking about. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
The docs covered installing the Avocado CLI but never the Avocado Desktop app, and no single page pointed a new user at both.
Solution
Add a "Download & Install" page under Getting Started that covers both products.
Key changes
getting-started/downloaddocumenting the macOS desktop DMG, the Homebrew cask, the macOS 13.0+ requirement, and the Windows/Linux "coming soon" state.Reviewer notes
npm run buildpasses: the new page renders at/developer-reference/getting-started/download, appears in the Getting Started sidebar, and its cross-link to the CLI installation guide resolves (Docusaurus fails the build on broken links).curl -fsSL https://connect.peridio.com/install.sh | shandbrew install --cask avocado-desktop) are documented, not executed in this change.