Skip to content

Commit

Permalink
Merge pull request #278 from pulsar-edit/tweak-manual-download-wording
Browse files Browse the repository at this point in the history
Tweak wording for the "Manual download" info on the download page
  • Loading branch information
DeeDeeG authored Jul 24, 2024
2 parents 52e55ed + 7d1ef96 commit 10c1602
Showing 1 changed file with 38 additions and 15 deletions.
53 changes: 38 additions & 15 deletions docs/download.md
Original file line number Diff line number Diff line change
@@ -190,32 +190,55 @@ You can bypass this by clicking "More info" then "Run anyway".
## Manual download

Binaries are built from a number of different branches and PRs but you should
stick to the **master** branch releases for the most stable ones unless you know
stick to the `master` branch releases for the most stable ones unless you know
exactly what you are looking for.

We currently build on both GitHub Actions and Cirrus CI:

- GitHub Actions is used for building the majority of our binaries and builds
are run on every commit or PR.
- Direct artifact download is available only for those with at least read
permission on the repository. All artifacts are therefore automatically
uploaded to the [pulsar-edit/pulsar-rolling-releases](https://github.com/pulsar-edit/pulsar-rolling-releases/releases)
repository for access by anyone.
- Cirrus CI is _only_ used for building Apple silicon (macOS M1/M2) and ARM
Linux binaries. These are run less frequently (every Monday, Wednesday, and Friday).

To download a binary produced by GitHub Actions then follow the below steps:
For the most convenient access to these recommended binaries
from the `master` branch, please visit our Rolling Releases repository on GitHub:

- Navigate to the [pulsar-edit/pulsar-rolling-releases](https://github.com/pulsar-edit/pulsar-rolling-releases/releases)
releases.
- Select the most recent release (or for a specific release reference the timestamp
part of the version e.g. 1.109.**2023091606**).
- Most binaries will be available with every release but Apple silicon and
ARM Linux binaries will not. You may need to look for earlier releases.
- x86_64 binaries will be grouped together for most releases,
but occasionally they will be split across multiple releases.
Apple silicon and ARM Linux binaries are usually, but not always,
grouped together in their own separate release. You may need to look through
the earlier releases to find binaries for your platform.
- Choose the binary you wish to download from the `Assets` section (you may need
click the `Show all x assets` link to display them all). See below for
descriptions of all available binaries.

We currently build on both GitHub Actions and Cirrus CI:

- GitHub Actions is used for building the majority of our binaries and builds
are run on every commit or PR.
- Direct artifact download is available only for those who are logged in
with their GitHub accounts.
- All artifacts from the `master` branch
are therefore automatically uploaded to the [pulsar-edit/pulsar-rolling-releases](https://github.com/pulsar-edit/pulsar-rolling-releases/releases)
repository for convenient access by anyone.
- Cirrus CI is _only_ used for building Apple silicon (macOS M1/M2) and ARM
Linux binaries. These are run less frequently (every Monday, Wednesday, and Friday).
- These are also uploaded to the [pulsar-edit/pulsar-rolling-releases](https://github.com/pulsar-edit/pulsar-rolling-releases/releases)
repository.

To directly download a binary produced by GitHub Actions, follow the below steps:

- Visit the Actions tab of the [`pulsar-edit/pulsar` repository at github.com](https://github.com/pulsar-edit/pulsar/actions/workflows/build.yml),
or visit a specific [Pull Request](https://github.com/pulsar-edit/pulsar/pulls)
that you wish to obtain binaries from.
- Log in to your GitHub account, or [create one](https://github.com/signup)
if you don't have one already.
- Visit the "Summary" page for any run of the "Build Pulsar Binaries" workflow,
and scroll down to the bottom of the page, where you will see the "Artifacts"
section.
- Download the desired binaries for your platform of choice.
- The labels are based on the CI runner, but the specific OS version should not
matter for your use. The "ubuntu" binaries are for any x64 Linux OSes.
The "macos-12" binaries are for any Intel-based Mac. Windows is x64-only
at this time.

To download a binary from Cirrus CI (Apple silicon and ARM Linux only) please
follow the below steps:

0 comments on commit 10c1602

Please sign in to comment.