anas/ganjoorandroid
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Put the download where someone looking for it will look #9

Merged
anas merged 2 commits from docs/download-link into main 2026-10-07 21:21:09 +00:00
Conversation 0 Commits 2 Files Changed 1 +9
anas commented 2026-10-07 21:18:44 +00:00
Owner
Copy Link

The APK has been in releases/ all along, but nothing on the front page said so — and the first thing most people want from an app's repository is the app.

Adds a Download section above the fold, before Reading:

  • releases/ganjoor-0.4.0.apk as a relative link, so it resolves on GitHub, on Gitea, and in any clone
  • the raw URL spelled out for anywhere the relative one doesn't resolve
  • the SHA-256 and the sha256sum line to check it
  • a pointer to releases/ for every earlier version, noting they all share one key so any upgrades any other in place

The part that matters most

It states plainly that Android will call the developer unknown and ask to install anyway.

That warning is what Android says about every app installed outside a store, but read cold it looks like the app is unsafe rather than merely unlisted. Better to say so first than to let someone hit it and assume the worst.

Verified

The raw URL was fetched end to end before writing it down:

HTTP/2 200, application/octet-stream, 31,658,315 bytes
magic:  PK..
sha256: 1c64cefa0fb2b51bf73386460ec1b88bda3e20832fa6926c2f7f1fb863ab9fc7  ✓ matches the archive

Docs only — no code, no build change.

Note: PR #8 can be closed as merged. Its content (releases/ganjoor-0.4.0.apk and metadata/com.ganjoor.android.yml) is already on main at c801d88 — it was merged on GitHub and I synced Gitea to match.

The APK has been in `releases/` all along, but nothing on the front page said so — and the first thing most people want from an app's repository is the app. Adds a **Download** section above the fold, before *Reading*: - **`releases/ganjoor-0.4.0.apk`** as a relative link, so it resolves on GitHub, on Gitea, and in any clone - the raw URL spelled out for anywhere the relative one doesn't resolve - the SHA-256 and the `sha256sum` line to check it - a pointer to [`releases/`](releases/) for every earlier version, noting they all share one key so any upgrades any other in place ## The part that matters most It states plainly that **Android will call the developer unknown and ask to install anyway**. That warning is what Android says about every app installed outside a store, but read cold it looks like the app is unsafe rather than merely unlisted. Better to say so first than to let someone hit it and assume the worst. ## Verified The raw URL was fetched end to end before writing it down: ``` HTTP/2 200, application/octet-stream, 31,658,315 bytes magic: PK.. sha256: 1c64cefa0fb2b51bf73386460ec1b88bda3e20832fa6926c2f7f1fb863ab9fc7 ✓ matches the archive ``` Docs only — no code, no build change. --- **Note:** PR #8 can be closed as merged. Its content (`releases/ganjoor-0.4.0.apk` and `metadata/com.ganjoor.android.yml`) is already on `main` at `c801d88` — it was merged on GitHub and I synced Gitea to match.
anas added 1 commit 2026-10-07 21:18:44 +00:00 
The APK has been in releases/ all along, but nothing on the front page said so,
and the first thing most people want from an app's repository is the app.

A Download section above the fold: the current build as a relative link that
works on any forge, the raw URL spelled out for anywhere the relative one does
not resolve, the checksum to verify it, and a pointer to releases/ for every
earlier version.

It also says plainly that Android will call the developer unknown and ask to
install anyway. That warning is what Android says about every app installed
outside a store, and read cold it looks like the app is unsafe rather than
merely unlisted — better to say so first than to let someone find out and
assume the worst.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
anas added 1 commit 2026-10-07 21:19:36 +00:00 
Below the tech line is already too far down. Someone who has just read what the
app is wants the app next, not the toolkit it is written in.

One line now, as a heading so it reads as a button rather than prose, with the
facts that decide whether to tap it beside it — Android version, size, older
releases, checksum — and the install warning under it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
anas merged commit 709a876348 into main 2026-10-07 21:21:09 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: anas/ganjoorandroid#9
No description provided.
Delete Branch "docs/download-link"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?