How to interpret all of the asset filenames?

[phil-s]

I feel like the explanation for the following should be in the FAQ.

The installation instructions cover a handful of packaged options, but if you don't use any of those it throws you at the following unexplained list, which is... a lot.

harper-chrome-plugin.zip
harper-cli-aarch64-apple-darwin.tar.gz
harper-cli-aarch64-unknown-linux-gnu.tar.gz
harper-cli-aarch64-unknown-linux-musl.tar.gz
harper-cli-x86_64-apple-darwin.tar.gz
harper-cli-x86_64-pc-windows-msvc.zip
harper-cli-x86_64-unknown-linux-gnu.tar.gz
harper-cli-x86_64-unknown-linux-musl.tar.gz
harper-darwin-arm64-0.46.0.vsix
harper-darwin-x64-0.46.0.vsix
harper-firefox-plugin.zip
harper-linux-arm64-0.46.0.vsix
harper-linux-x64-0.46.0.vsix
harper-ls-aarch64-apple-darwin.tar.gz
harper-ls-aarch64-unknown-linux-gnu.tar.gz
harper-ls-aarch64-unknown-linux-musl.tar.gz
harper-ls-x86_64-apple-darwin.tar.gz
harper-ls-x86_64-pc-windows-msvc.zip
harper-ls-x86_64-unknown-linux-gnu.tar.gz
harper-ls-x86_64-unknown-linux-musl.tar.gz
harper-win32-x64-0.46.0.vsix
harper.zip
Source code (tar.gz)

Some of it's pretty clear (e.g. "harper-firefox-plugin.zip"), others not so much (e.g. "gnu" being opposed to "musl" was completely meaningless to me).

Apparently musl is an alternative to glibc, so that makes sense with context.

"vsix" is apparently for Visual Studio.

"darwin" I happen to know is a MacOS thing.

The internet reckons that "AArch64" and "ARM64" are the same thing, so it's weird that they both appear. (And similarly for "x86-64" and "x64").

An annotated list in the FAQ would certainly make things simpler for new users.

As a starter, my interpretation is this:

harper-firefox-plugin.zip                     Web browser plugin for Mozilla Firefox
harper-chrome-plugin.zip                      Web browser plugin for Google Chrome

harper-cli-aarch64-apple-darwin.tar.gz        harper-cli for MacOS with AArch64 (ARM64) CPU
harper-cli-aarch64-unknown-linux-gnu.tar.gz   harper-cli for GNU/Linux with AArch64 (ARM64) CPU, and using glibc instead of musl
harper-cli-aarch64-unknown-linux-musl.tar.gz  harper-cli for GNU/Linux with AArch64 (ARM64) CPU, and using musl instead of glibc

harper-cli-x86_64-apple-darwin.tar.gz         harper-cli for MacOS with x86-64 (AMD64 / Intel64) CPU
harper-cli-x86_64-pc-windows-msvc.zip         harper-cli for Microsoft Windows with x86-64 (AMD64 / Intel64) CPU
harper-cli-x86_64-unknown-linux-gnu.tar.gz    harper-cli for GNU/Linux with x86-64 (AMD64 / Intel64) CPU, and using glibc instead of musl
harper-cli-x86_64-unknown-linux-musl.tar.gz   harper-cli for GNU/Linux with x86-64 (AMD64 / Intel64) CPU, and using musl instead of glibc

harper-darwin-arm64-0.46.0.vsix               Visual Studio plugin for MacOS with AArch64 (ARM64) CPU
harper-darwin-x64-0.46.0.vsix                 Visual Studio plugin for MacOS with x86-64 (AMD64 / Intel64) CPU
harper-linux-arm64-0.46.0.vsix                Visual Studio plugin for GNU/Linux with AArch64 (ARM64) CPU
harper-linux-x64-0.46.0.vsix                  Visual Studio plugin for GNU/Linux with x86-64 (AMD64 / Intel64) CPU
harper-win32-x64-0.46.0.vsix                  Visual Studio plugin for Microsoft Windows with x86-64 (AMD64 / Intel64) CPU

harper-ls-aarch64-apple-darwin.tar.gz         harper-ls for MacOS with AArch64 (ARM64) CPU
harper-ls-aarch64-unknown-linux-gnu.tar.gz    harper-ls for GNU/Linux with AArch64 (ARM64) CPU, and using glibc instead of musl
harper-ls-aarch64-unknown-linux-musl.tar.gz   harper-ls for GNU/Linux with AArch64 (ARM64) CPU, and using musl instead of glibc

harper-ls-x86_64-apple-darwin.tar.gz          harper-ls for MacOS with x86-64 (AMD64 / Intel64) CPU
harper-ls-x86_64-pc-windows-msvc.zip          harper-ls for with Microsoft Windows with x86-64 (AMD64 / Intel64) CPU
harper-ls-x86_64-unknown-linux-gnu.tar.gz     harper-ls for GNU/Linux with x86-64 (AMD64 / Intel64) CPU, and using glibc instead of musl
harper-ls-x86_64-unknown-linux-musl.tar.gz    harper-ls for GNU/Linux with x86-64 (AMD64 / Intel64) CPU, and using musl instead of glibc

harper.zip                                    Source code as zip archive
Source code (tar.gz)                          Source code as tar.gz archive

[elijah-potter]

Howdy,

I'm sorry that I didn't this question until now. I'm sure the usefulness of my answer has dramatically declined in the intervening time, but others may stumble upon this discussion, so I'll answer anyway.

There are several broad categories, each of which you've touched on.

harper-chrome-plugin and harper-firefox-plugin are the browser extensions. Despite the name, the former can be used in any Chromium-based browser, not just Chrome itself.

The archives prefixed with harper-cli-* and harper-ls-* contain the binaries for harper-cli and harper-ls for the suffix's platform. Platforms are defined using a Rust target triple.

The .vsix files are, as you said, the Visual Studio Code plugins for the various platforms.

harper.zip is unfortunately named, since it actually contains the WordPress plugin (which is being phased out).

I think that's all the relevant files. Let me know if you have any other questions!

[phil-s]

Thanks! I think it would be valuable to have this information in one or more of the following locations:

• Alongside the release Assets listing itself, if it's possible to add common documentation for those. This would be ideal, but failing that...
• The GitHub-Releases section of the harper-ls installation documentation. If the info can't be included in the Assets list, this seems like the next best place to put it.
• The FAQ at https://writewithharper.com/#faqs (maybe just as a link to whichever of the previous locations worked best)