Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions HISTORY.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,11 @@
## 2026-07-27 - The Trendshift daily-Kotlin award on the README and landing hero

- Trigger: Trendshift ranked the repository #1 Kotlin repository of the day on 23 Jul 2026, and the maintainer asked whether the badge it hands out belonged on the README. It did, and the landing pages were added in the same pass.
- Analysis: the snippet Trendshift generates embeds their live badge URL, and the two public surfaces fetch images very differently. GitHub proxies README images through camo, so a reader never contacts Trendshift and a live badge stays accurate on its own. GitHub Pages proxies nothing — the same URL there would have every visitor's browser hit a third party, on the page whose whole argument is that Markleaf does not phone home. The snippet also carries `target="_blank" rel="noopener noreferrer"`, which GitHub strips and replaces with `rel="nofollow"`, and a URL-encoded `alt` (`jeiel85%2Fmarkleaf-android | Trendshift`).
- Contract/scope: live URL in the six READMEs, a checked-in copy of the SVG (3.7 KB, self-contained — no external refs or scripts, internal gradient ids only) on the six landing pages. README block sits between the tagline and the shields row, because a 250x55 badge beside 20px shields reads badly; landing markup is one `a.hero-award` under the release line, with a three-line CSS rule since the global `img` rule already caps width. Alt text translated per language, the way the demo clips already are. `docs/assets/README.md` records why the file is checked in and how to refresh it.
- Verification: `check-landing-overflow.mjs` passes 12 pages x 6 widths; `verify-landing-versions.ps1` still passes. A headless render of all six landing pages at 320px and 1280px confirms the SVG loads (natural 250x55), renders at 250x55, sits 24px below the release line, stays inside the viewport and the hero block, and carries non-empty alt everywhere. `gh api -X POST markdown` on the README header confirms the embed survives GitHub's sanitiser with its link (utm parameters intact), dimensions and alt.
- No CHANGELOG entry, against the Codex review's P1: that file is strictly version-sectioned and is the literal source the release job's awk parser cuts release notes from, it has no Unreleased section, and this change carries no version bump — recording it would mean inventing a version or editing v2.32.1's already-published notes. Nothing about the app changed. PR #282, the nearest analogue, logged HISTORY only for the same reason.

## 2026-07-27 - The editor caret takes the theme's colour, and v2.32.1 (#283)

- Trigger: an F-Droid user on 2.28.3 wrote in with two screenshots — a dark page, a themed drag handle, and a black caret they had to hunt for, in both Markleaf Green and Material You (#283).
Expand Down
4 changes: 4 additions & 0 deletions README.de.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@
Eine local-first, minimalistische Markdown-Notiz-App für Android
</p>

<p align="center">
<a href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-58116"><img src="https://trendshift.io/api/badge/trendshift/repositories/58116/daily?language=Kotlin" width="250" height="55" alt="Markleaf — Kotlin-Repository des Tages auf Trendshift, Platz 1" /></a>
</p>

<p align="center">
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?logo=android&logoColor=white" alt="Platform" />
<img src="https://img.shields.io/badge/Language-Kotlin-7F52FF?logo=kotlin&logoColor=white" alt="Language" />
Expand Down
4 changes: 4 additions & 0 deletions README.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@
Una app de notas Markdown minimalista y local-first para Android
</p>

<p align="center">
<a href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-58116"><img src="https://trendshift.io/api/badge/trendshift/repositories/58116/daily?language=Kotlin" width="250" height="55" alt="Markleaf — repositorio Kotlin del día n.º 1 en Trendshift" /></a>
</p>

<p align="center">
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?logo=android&logoColor=white" alt="Platform" />
<img src="https://img.shields.io/badge/Language-Kotlin-7F52FF?logo=kotlin&logoColor=white" alt="Language" />
Expand Down
4 changes: 4 additions & 0 deletions README.fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@
Une application de notes Markdown minimaliste et local-first pour Android
</p>

<p align="center">
<a href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-58116"><img src="https://trendshift.io/api/badge/trendshift/repositories/58116/daily?language=Kotlin" width="250" height="55" alt="Markleaf — dépôt Kotlin n° 1 du jour sur Trendshift" /></a>
</p>

<p align="center">
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?logo=android&logoColor=white" alt="Platform" />
<img src="https://img.shields.io/badge/Language-Kotlin-7F52FF?logo=kotlin&logoColor=white" alt="Language" />
Expand Down
4 changes: 4 additions & 0 deletions README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@
Android 向けのローカルファースト・ミニマルな Markdown メモアプリ
</p>

<p align="center">
<a href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-58116"><img src="https://trendshift.io/api/badge/trendshift/repositories/58116/daily?language=Kotlin" width="250" height="55" alt="Markleaf — Trendshift のデイリー Kotlin リポジトリ 1 位" /></a>
</p>

<p align="center">
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?logo=android&logoColor=white" alt="Platform" />
<img src="https://img.shields.io/badge/Language-Kotlin-7F52FF?logo=kotlin&logoColor=white" alt="Language" />
Expand Down
4 changes: 4 additions & 0 deletions README.ko.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@
Android용 로컬 우선(Local-first) 미니멀 Markdown 메모 앱
</p>

<p align="center">
<a href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-58116"><img src="https://trendshift.io/api/badge/trendshift/repositories/58116/daily?language=Kotlin" width="250" height="55" alt="Markleaf — Trendshift 일간 Kotlin 저장소 1위" /></a>
</p>

<p align="center">
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?logo=android&logoColor=white" alt="Platform" />
<img src="https://img.shields.io/badge/Language-Kotlin-7F52FF?logo=kotlin&logoColor=white" alt="Language" />
Expand Down
4 changes: 4 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@
A local-first, minimal Markdown note app for Android
</p>

<p align="center">
<a href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-58116"><img src="https://trendshift.io/api/badge/trendshift/repositories/58116/daily?language=Kotlin" width="250" height="55" alt="Markleaf — #1 Kotlin repository of the day on Trendshift" /></a>
</p>

<p align="center">
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?logo=android&logoColor=white" alt="Platform" />
<img src="https://img.shields.io/badge/Language-Kotlin-7F52FF?logo=kotlin&logoColor=white" alt="Language" />
Expand Down
24 changes: 24 additions & 0 deletions docs/assets/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,3 +50,27 @@ URLs regardless.
| `markleaf-feature-graphic-1024x500.png` | Play Console feature graphic |
| `markleaf-playstore-icon-512.png` | Play Console app icon |
| `logo.svg` | Landing header |

## Badges

| File | Use |
|---|---|
| `trendshift-daily-kotlin.svg` | Landing hero award badge, all six languages |

### Why a local copy and not Trendshift's live badge URL

Trendshift serves this badge from `trendshift.io/api/badge/…`, and that is what
the six READMEs embed: GitHub proxies README images through camo, so a reader
never contacts Trendshift. GitHub Pages proxies nothing. Embedding the live URL
here would have every visitor's browser hit a third party, on the page whose
whole argument is that Markleaf does not phone home — so the landing pages serve
this checked-in copy instead.

The cost is that the file no longer follows the live badge. That is acceptable
because it records a dated achievement — #1 Kotlin repository of the day, first
reached 23 Jul 2026 — and not a current standing. Re-download it only if the
award itself changes:

```
curl -L "https://trendshift.io/api/badge/trendshift/repositories/58116/daily?language=Kotlin" -o docs/assets/trendshift-daily-kotlin.svg
```
7 changes: 7 additions & 0 deletions docs/assets/trendshift-daily-kotlin.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions docs/index.de.html
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,9 @@ <h1 id="hero-title">Notizen auf deinem Gerät.<br><span>Gedanken in Markdown.</s
<a class="action action-secondary" href="https://github.com/jeiel85/markleaf-android/releases/latest">GitHub APK</a>
</div>
<p class="release-line">Jetzt v2.32.1 · Kostenlos · Apache-2.0</p>
<a class="hero-award" href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-58116">
<img src="assets/trendshift-daily-kotlin.svg" width="250" height="55" alt="Markleaf — Kotlin-Repository des Tages auf Trendshift, Platz 1">
</a>
</div>

<figure class="hero-product">
Expand Down
3 changes: 3 additions & 0 deletions docs/index.es.html
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,9 @@ <h1 id="hero-title">Notas en tu dispositivo.<br><span>Pensamientos en Markdown.<
<a class="action action-secondary" href="https://github.com/jeiel85/markleaf-android/releases/latest">GitHub APK</a>
</div>
<p class="release-line">Ahora v2.32.1 · Gratis · Apache-2.0</p>
<a class="hero-award" href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-58116">
<img src="assets/trendshift-daily-kotlin.svg" width="250" height="55" alt="Markleaf — repositorio Kotlin del día n.º 1 en Trendshift">
</a>
</div>

<figure class="hero-product">
Expand Down
3 changes: 3 additions & 0 deletions docs/index.fr.html
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,9 @@ <h1 id="hero-title">Notes sur votre appareil.<br><span>Pensées en Markdown.</sp
<a class="action action-secondary" href="https://github.com/jeiel85/markleaf-android/releases/latest">GitHub APK</a>
</div>
<p class="release-line">Maintenant v2.32.1 · Gratuit · Apache-2.0</p>
<a class="hero-award" href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-58116">
<img src="assets/trendshift-daily-kotlin.svg" width="250" height="55" alt="Markleaf — dépôt Kotlin n° 1 du jour sur Trendshift">
</a>
</div>

<figure class="hero-product">
Expand Down
3 changes: 3 additions & 0 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,9 @@ <h1 id="hero-title">Notes on your device.<br><span>Thoughts in Markdown.</span><
<a class="action action-secondary" href="https://github.com/jeiel85/markleaf-android/releases/latest">GitHub APK</a>
</div>
<p class="release-line">Now v2.32.1 · Free · Apache-2.0</p>
<a class="hero-award" href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-58116">
<img src="assets/trendshift-daily-kotlin.svg" width="250" height="55" alt="Markleaf — #1 Kotlin repository of the day on Trendshift">
Comment on lines +95 to +96

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Record the user-facing documentation change

This adds the award to the public README and landing surfaces, but the commit updates neither CHANGELOG.md nor HISTORY.md. The repository requires user-impacting changes to be recorded in the changelog and every work unit to be logged in project history, so add the corresponding entries before merging.

AGENTS.md reference: AGENTS.md:L219-L223

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Half of this is right, and it is fixed in 1367b22.

HISTORY.md — agreed. AGENTS.md:222 asks for a work-unit entry, and PR #282 (a docs-only landing and README change) set the precedent by logging one. Added.

CHANGELOG.md — not applicable here. CHANGELOG.md is strictly version-sectioned (## vX.Y.Z - Title - YYYY-MM-DD) and is the literal source the release job's awk parser cuts GitHub release notes from — AGENTS.md:229-231 makes that dependency explicit, and the job fails on test -s release-title.txt if the shape breaks. There is no Unreleased section, and this PR carries no version bump, so recording it would mean either inventing a version section or editing v2.32.1's already-tagged and already-published release notes. Nothing about the app changed either: the badge is on the README and the landing hero, and an APK built before and after this commit is identical.

AGENTS.md:219 also scopes that list to 코드 변경 시 — when code changes. PR #282 is the nearest analogue and updated HISTORY without touching CHANGELOG, which is the same call.

The reasoning is recorded in the HISTORY entry so the question does not have to be re-litigated next time.

</a>
</div>

<figure class="hero-product">
Expand Down
3 changes: 3 additions & 0 deletions docs/index.ja.html
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,9 @@ <h1 id="hero-title">ノートは端末に。<br><span>思考は Markdown で。<
<a class="action action-secondary" href="https://github.com/jeiel85/markleaf-android/releases/latest">GitHub APK</a>
</div>
<p class="release-line">現在 v2.32.1 · 無料 · Apache-2.0</p>
<a class="hero-award" href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-58116">
<img src="assets/trendshift-daily-kotlin.svg" width="250" height="55" alt="Markleaf — Trendshift のデイリー Kotlin リポジトリ 1 位">
</a>
</div>

<figure class="hero-product">
Expand Down
3 changes: 3 additions & 0 deletions docs/index.ko.html
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,9 @@ <h1 id="hero-title">메모는 기기에.<br><span>생각은 Markdown으로.</spa
<a class="action action-secondary" href="https://github.com/jeiel85/markleaf-android/releases/latest">GitHub APK</a>
</div>
<p class="release-line">현재 v2.32.1 · 무료 · Apache-2.0</p>
<a class="hero-award" href="https://trendshift.io/repositories/58116?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-58116">
<img src="assets/trendshift-daily-kotlin.svg" width="250" height="55" alt="Markleaf — Trendshift 일간 Kotlin 저장소 1위">
</a>
</div>

<figure class="hero-product">
Expand Down
5 changes: 5 additions & 0 deletions docs/landing.css
Original file line number Diff line number Diff line change
Expand Up @@ -415,6 +415,11 @@ li {
margin-top: var(--space-4);
}

.hero-award {
display: inline-block;
margin-top: var(--space-6);
}

.hero-product {
margin: var(--space-8) 0;
padding-bottom: var(--space-8);
Expand Down
Loading