Skip to content

Docs: follow the Install and Verify steps on a clean phone and report confusing parts #4

Closed

Description

@gautamgpt1

The README's Install and
Verifying a release sections were written by
people who already know the project. We would like a fresh reader to test them, because install instructions are the
first thing every user depends on.

What to do

  1. Without asking anyone, follow the README from the top on a phone that has never had MeshLive. Note every place you
    hesitated, had to guess, or where the screen on your phone did not match the text (browser, manufacturer skin,
    Android version).
  2. Try at least the hash check, and the certificate check if you are comfortable with apksigner. If you have the
    GitHub CLI, try gh attestation verify as shown in the README.
  3. Comment here with what was unclear, or open a pull request that fixes the wording. Small pull requests are fine:
    typos, a missing step, an out-of-date screenshot, a term that needs explaining.

Also useful: a short glossary for words the README uses without explaining (GATT, CoC, relay, hop, attestation), and
extra questions for the FAQ that you would have asked.

The privacy warning at the top of the README must stay as it is; if you think it is unclear, say so in a comment
rather than editing it.

Activity

  1. Aaqibhafeezkhan commented on Oct 21, 2026

    @Aaqibhafeezkhan
    Contributor

    Hi! I'd like to review the install and release-verification instructions from a fresh-device perspective. I'll follow the README step by step, record any unclear instructions or mismatches with the phone, and attempt the documented hash verification. I'll report the device and Android version, distinguish checks I actually completed from ones I couldn't run, and suggest focused wording fixes where appropriate.

  2. gautamgpt1 commented on Oct 22, 2026

    @gautamgpt1
    MemberAuthor

    Sounds good. Just a heads-up: the documentation was restructured with v0.3.0, so the README sections linked in the original issue have moved. The current install and verification instructions are in docs/user-guide.md.

    Please use the updated guide for testing and share any issues you find here. Documentation PRs are welcome too.

  3. gautamgpt1 commented on Oct 22, 2026

    @gautamgpt1
    MemberAuthor

    Fixed by #11, thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomershelp wantedExtra attention is needed

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions