[Nomee-123]

Summary

• Add a compact troubleshooting guide for installation failures.
• Document next steps for version, asset, download, Sigstore, checksum, and platform errors.
• Include links to Sotto releases and the repository issue tracker.

Closes #16

[Maxerns]

Thanks @Nomee-123 the structure, next steps, and links are all good, and keeping the pins/examples untouched is exactly right.

There’s one blocking issue before this can merge:

Restore the missing error messages

All six ### headings are currently empty, and a few inline code spans also came through blank, for example:

in  format, such as .

The purpose of this guide is to map the actual installer wording to the correct next steps, so each error message needs to be restored as an inline code span, copied verbatim from the scripts.

Please restore the following:

• sotto-version must be an exact release such as v0.4.0

  • Source: scripts/validate-version.sh / .ps1

• release asset not found: …

  • Source: scripts/install.sh / .ps1

• download failed: …

  • Source: scripts/install.sh / .ps1

• Sigstore verification failed for …

  • Source: both installers

• checksum verification failed for …

  • Source: scripts/verify-checksum.sh / .ps1

• no prebuilt Sotto binary for …

  • Shell wording uses $os/$arch
  • PowerShell wording uses Windows/$Architecture

Happy to re-review once those are restored.

[Maxerns]

Thanks @Nomee-123 for the updates.