Poor Installation Documentation

[rtfmoz2]

Description

The instructions for non developers to install into Windows is quite poor.

Steps to Reproduce

Get a person who is not familiar with the project to try and set it up under Windows

Give them the following guidelines --- STOP the install and report back if any of the following occur.

• you have to guess about any part of the process
• you had to repeat steps to try another way
• you have to google something
• you have questions before you can proceed

Additional Information

A lifetime in IT and an identity specialist so I know my way around systems. The documentation framework is great, the mkdocs system is excellent. There is no flow in the documentation for installation. There are a ton of assumptions which comes from the forest for the trees paradigm.

Affected Websites

The main documentation for installation

Environment

• Operating system: Windows 11
• System architecture: x64
• Desktop environment:
• Installation method: Did not know which to use
• PWAsForFirefox extension version: 2.15.0
• PWAsForFirefox native version: 2.15.0
• PWAsForFirefox runtime version: Where do I even find this??
• Firefox version: 141.0 (64 bit)

[rtfmoz2]

Proposed changes in #721

[TreeBranches]

Since the built in Windows zip utility now supports 7z, I don't see a reason to include 7zip any longer.

[filips123]

Only on Windows 11, and I don't know if it actually supports extracting EXE files.