QA: v0.3.1 MacOS x86_64

[Rūdolfs Ošiņš]

Prerequisites

• Make sure you are installing into an environment with no old
  configuration and no user data ℹ️
• Make sure you have configured your name and email in git ℹ️
• Download the macOS binary package
• Install Upstream from the downloaded package ℹ️
  • macOS Gatekeeper does not show the following message:
    macOS cannot verify that this app is free from malware

QA checklist

Onboarding

• Start Upstream
  • on Linux: run PATH_TO_DOWNLOAD>/radicle-upstream-0.3.1-rc.AppImage by
    executing it from the terminal or clicking on it
  • on macOS: run /Applications/Radicle Upstream.app by double clicking it
• Complete all the onboarding steps until you land on the Profile screen

Replication

• Replicate radicle-upstream (rad:git:hnrk8ueib11sen1g9n1xbt71qdns9n4gipw1o)
  • Syntax highlighting works for source files (.toml, .ts, .svelte, etc.)
  • README.md files are shown by default and markdown is rendered as HTML
    • Links to external resources open in external browser
    • Links to internal resources don't do anything

Settings & Misc

• The version number in the Settings screen matches:
  • The version number in the package filename
  • The version number in the About Radicle Upstream dialog

Hints

How to set up a clean environemnt? 🔗

Safe method: use a temporary user account on your computer.

• on macOS:
  • if you are not using FileVault, switch to the "Guest User". You may
    have to enable this in "System Preferences -> Users & Groups". When
    you're done, all data will be removed automatically.
  • if you are using FileVault, create a new user in "System
    Preferences -> Users & Groups". When you're done, you'll need to remove
    this user manually.
• on Linux:
  • create a new user with sudo useradd -m qa, and log into that account.
    When you're done, remove the user with sudo userdel -r qa. Note:
    "qa" is just an example user name, you can choose anything you like

Dangerous method: remove all directories manually.

You can use this script. Make sure you have a backup of your data,
or are using this in combination with the safe method (i.e. while logged
in with a temporary user account).

How to set up git? 🔗

git config --global user.name "Mona Lisa"
git config --global user.email "[e-mail]"

How to install? 🔗

On macOS:

1. open the radicle-upstream-0.3.1-rc.dmg package
2. install Upstream by dragging the Radicle Upstream binary to
   /Applications

On Linux (AppImage):

1. chmod +x <PATH_TO_DOWNLOAD>/radicle-upstream-0.3.1-rc.AppImage

[Rūdolfs Ošiņš]

QA pass.