From 450dd11fed67e0f091b64495d13f33b4edcd05ea Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=B0=95=EC=9A=A9=EC=9D=80?= Date: Tue, 28 Jul 2026 09:57:55 +0900 Subject: [PATCH] docs: align distribution guidance --- .agent/decisions.md | 20 ++++++++++++++ .agent/progress.md | 14 ++++++++++ .agent/tasks.md | 5 ++++ HISTORY.md | 15 +++++++++++ README.de.md | 8 +++--- README.es.md | 8 +++--- README.fr.md | 8 +++--- README.ja.md | 8 +++--- README.ko.md | 8 +++--- README.md | 8 +++--- docs/COMMERCIAL_READINESS_PLAN.md | 10 ++++--- docs/ROADMAP.md | 44 ++++++++++++++++++++++++++++++- 12 files changed, 128 insertions(+), 28 deletions(-) diff --git a/.agent/decisions.md b/.agent/decisions.md index d16cdf98..2fdaca2b 100644 --- a/.agent/decisions.md +++ b/.agent/decisions.md @@ -7,6 +7,26 @@ ## Confirmed Decisions +### D065 - Distribution Guidance Separates Current Release From Update Channels + +GitHub Releases is the public source of the current signed APK. F-Droid remains the +recommended route for automatic updates once its catalog has published that version. +GitLab remains a source mirror, but its release assets are not an installation promise. + +Why: +- Google Play updates are currently paused, so the public documentation must name one + unambiguous current-release source. +- F-Droid publication is valuable for trusted updates but can lag a GitHub release. +- The GitLab release publication step has had quota and availability failures; presenting + it as interchangeable with GitHub can direct a user to an older or missing asset. + +Decision: +- All six READMEs describe the same channel hierarchy. +- `docs/ROADMAP.md` treats distribution reliability and real-user evidence as the next + gate, ahead of new broad features. +- This changes documentation and operations only; it does not add network access, + analytics, accounts, or any new runtime dependency. + ### D064 - The R8 Mapping Is Not A GitHub Release Asset Either The GitHub Release carries exactly one asset, the signed APK. The R8 mapping is diff --git a/.agent/progress.md b/.agent/progress.md index e70b69b6..26fdd2d5 100644 --- a/.agent/progress.md +++ b/.agent/progress.md @@ -1,3 +1,17 @@ +## 2026-07-28 - Project direction and distribution documentation refreshed + +Selected task: +- Align public installation guidance and the active roadmap with the observed release channels and current product stage. + +What changed: +- Updated all six READMEs: GitHub Releases is the current signed-APK source, F-Droid is the automatic-update path after catalog publication, and GitLab is a source mirror rather than an installation promise. +- Added a 2026-07–10 stabilization, distribution, and user-evidence gate to `docs/ROADMAP.md`; moved the older feature phases to an explicitly deferred backlog. +- Marked the commercial-readiness document as historical-complete and linked it to the active operating plan. + +Verification: +- `pwsh scripts/verify-landing-versions.ps1` +- Manual parity review of all six installation sections and their current v2.32.1 release links. + --- ## 2026-07-16 - main 브랜치 통합과 GitLab v2.24 정렬 diff --git a/.agent/tasks.md b/.agent/tasks.md index bf643738..2d5f43b9 100644 --- a/.agent/tasks.md +++ b/.agent/tasks.md @@ -5,6 +5,11 @@ --- +## User-requested Project Direction Refresh (Done, 2026-07-28) + +- [x] 공개 저장소·릴리스·CI·배포 채널을 점검하고, 최신 설치 경로와 3/6개월 안정화 게이트를 + `README*.md`와 `docs/ROADMAP.md`에 반영 + ## User-requested Public Surface Renewal (Done, 2026-07-15) - [x] GitHub Pages 랜딩을 Quiet proof 방향으로 재구성하고 실제 앱 화면, no-INTERNET 증거, F-Droid 우선 설치 경로, 반응형·접근성·SEO를 검증 diff --git a/HISTORY.md b/HISTORY.md index fa7e1bb6..96b9d7f0 100644 --- a/HISTORY.md +++ b/HISTORY.md @@ -1,3 +1,18 @@ +## 2026-07-28 - Project direction and distribution guidance aligned + +- Trigger: a repository review found a mature local-first app with an outdated feature + roadmap, a paused Google Play channel, an F-Droid catalog that can trail GitHub, and + GitLab release-asset publication that is not reliable enough to advertise as an equal + installation path. +- Contract/scope: no application code, permissions, telemetry, account, dependency, or + release version changed. The six README installation sections now distinguish GitHub + Releases (current signed APK), F-Droid (automatic updates after catalog publication), + and GitLab (source mirror). `docs/ROADMAP.md` gains a July–October stabilization, + distribution, and user-evidence gate; the older feature phases remain deferred ideas. +- Verification: `pwsh scripts/verify-landing-versions.ps1` and a line-by-line parity + review of all six README installation sections. `./gradlew test` had already passed on + the unchanged v2.32.1 source tree during the repository assessment. + ## 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. diff --git a/README.de.md b/README.de.md index a9a723a4..7eeb729a 100644 --- a/README.de.md +++ b/README.de.md @@ -34,7 +34,7 @@

GitHub-Repository · Discussions (Feedback) · - Öffentlicher GitLab-Mirror + GitLab-Quellcode-Mirror

@@ -163,11 +163,11 @@ com.markleaf.notes ### Installation > [!NOTE] -> **Google-Play-Updates sind derzeit ausgesetzt.** Bis eine koreanische Gewerbeanmeldungs-Anforderung für den Einzelentwickler geklärt ist, werden keine neuen Versionen in den Play Store geladen. Hol dir in der Zwischenzeit **die neueste Version über F-Droid, GitHub Releases oder GitLab Releases.** (Wenn du sie bereits aus dem Play Store installiert hast, funktioniert sie weiterhin.) +> **Google-Play-Updates sind derzeit ausgesetzt.** Bis eine koreanische Gewerbeanmeldungs-Anforderung für den Einzelentwickler geklärt ist, werden keine neuen Versionen in den Play Store geladen. Die aktuelle Version bekommst du über **GitHub Releases**. Sobald der F-Droid-Build nachgezogen hat, ist F-Droid der empfohlene Update-Weg. (Wenn du sie bereits aus dem Play Store installiert hast, funktioniert sie weiterhin.) -- **F-Droid** *(empfohlen)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) – im F-Droid-Client suchen oder über den Link oben installieren. Es wird derselbe Signaturschlüssel (SHA-256 `0be97352…f91a`) verwendet, sodass Updates auch dann nahtlos weiterlaufen, wenn du ein APK aus den GitHub- oder GitLab-Releases per Sideload installiert hast. +- **F-Droid** *(für automatische Updates empfohlen)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) – im F-Droid-Client suchen oder über den Link oben installieren. Der Katalog kann später als GitHub veröffentlichen; falls die aktuelle Version noch nicht angezeigt wird, nutze unten GitHub Releases. Es wird derselbe Signaturschlüssel (SHA-256 `0be97352…f91a`) verwendet, sodass Updates auch nach einem ersten Sideload eines GitHub-APKs nahtlos weiterlaufen. - **Direkte APK-Installation**: lade das APK aus dem [GitHub-v2.32.1-Release](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1) herunter und führe es auf deinem Android-Gerät aus. -- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) – **Updates sind ausgesetzt** (siehe Hinweis oben). Wenn du die App bereits hast, funktioniert sie weiter, aber die neueste Version gibt es über F-Droid, GitHub oder GitLab. +- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) – **Updates sind ausgesetzt** (siehe Hinweis oben). Wenn du die App bereits hast, funktioniert sie weiter; die aktuelle Version gibt es über GitHub Releases oder nach Veröffentlichung über F-Droid. ### Aus dem Quellcode bauen Wenn du selbst bauen oder beitragen möchtest, folge diesen Schritten. diff --git a/README.es.md b/README.es.md index a2b39182..9a3b821b 100644 --- a/README.es.md +++ b/README.es.md @@ -34,7 +34,7 @@

Repositorio de GitHub · Discussions (sugerencias) · - Espejo público de GitLab + Espejo de código fuente en GitLab

@@ -163,11 +163,11 @@ com.markleaf.notes ### Instalación > [!NOTE] -> **Las actualizaciones en Google Play están en pausa por ahora.** No se publicarán nuevas versiones en la Play Store hasta que se resuelva un requisito de política de registro de negocio en Corea para el desarrollador individual. Mientras tanto, **obtén la última versión desde F-Droid, GitHub Releases o GitLab Releases.** (Si ya la instalaste desde la Play Store, seguirá funcionando.) +> **Las actualizaciones en Google Play están en pausa por ahora.** No se publicarán nuevas versiones en la Play Store hasta que se resuelva un requisito de política de registro de negocio en Corea para el desarrollador individual. Para obtener la versión actual, usa **GitHub Releases**. Cuando la compilación de F-Droid se haya puesto al día, F-Droid será la ruta de actualización recomendada. (Si ya la instalaste desde la Play Store, seguirá funcionando.) -- **F-Droid** *(recomendado)*: [Markleaf en F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — búscalo en el cliente de F-Droid o instálalo con el enlace de arriba. Usa la misma clave de firma (SHA-256 `0be97352…f91a`), así que las actualizaciones continúan sin problemas incluso si instalaste un APK de GitHub o GitLab Releases mediante sideload. +- **F-Droid** *(recomendado para actualizaciones automáticas)*: [Markleaf en F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — búscalo en el cliente de F-Droid o instálalo con el enlace de arriba. El catálogo puede publicarse después de GitHub; si aún no muestra la versión actual, usa GitHub Releases a continuación. Usa la misma clave de firma (SHA-256 `0be97352…f91a`), así que las actualizaciones continúan sin problemas aunque primero instales por sideload un APK de GitHub. - **Instalación directa del APK**: descarga el APK desde el [release v2.32.1 de GitHub](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1), y ejecútalo en tu dispositivo Android. -- **Google Play**: [Markleaf en Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **las actualizaciones están en pausa** (ver la nota de arriba). Si ya la tienes instalada, seguirá funcionando, pero obtén la última versión desde F-Droid, GitHub o GitLab. +- **Google Play**: [Markleaf en Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **las actualizaciones están en pausa** (ver la nota de arriba). Si ya la tienes instalada, seguirá funcionando; obtén la versión actual desde GitHub Releases o desde F-Droid cuando esté disponible allí. ### Compilar desde el código fuente Si quieres compilar el proyecto o contribuir, sigue estos pasos. diff --git a/README.fr.md b/README.fr.md index 94a91cfe..bef5a00d 100644 --- a/README.fr.md +++ b/README.fr.md @@ -34,7 +34,7 @@

Dépôt GitHub · Discussions (retours) · - Miroir public GitLab + Miroir du code source GitLab

@@ -163,11 +163,11 @@ com.markleaf.notes ### Installation > [!NOTE] -> **Les mises à jour sur Google Play sont actuellement en pause.** Aucune nouvelle version ne sera publiée sur le Play Store tant qu'une exigence de politique d'enregistrement d'entreprise en Corée pour le développeur indépendant ne sera pas résolue. En attendant, **obtenez la dernière version via F-Droid, GitHub Releases ou GitLab Releases.** (Si vous l'avez déjà installée depuis le Play Store, elle continue de fonctionner.) +> **Les mises à jour sur Google Play sont actuellement en pause.** Aucune nouvelle version ne sera publiée sur le Play Store tant qu'une exigence de politique d'enregistrement d'entreprise en Corée pour le développeur indépendant ne sera pas résolue. Pour la version actuelle, utilisez **GitHub Releases**. Une fois que la compilation F-Droid est à jour, F-Droid reste le canal de mise à jour recommandé. (Si vous l'avez déjà installée depuis le Play Store, elle continue de fonctionner.) -- **F-Droid** *(recommandé)* : [Markleaf sur F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — recherchez-le dans le client F-Droid ou installez-le via le lien ci-dessus. Il utilise la même clé de signature (SHA-256 `0be97352…f91a`), donc les mises à jour continuent sans interruption même si vous avez installé un APK via sideload depuis GitHub ou GitLab Releases. +- **F-Droid** *(recommandé pour les mises à jour automatiques)* : [Markleaf sur F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — recherchez-le dans le client F-Droid ou installez-le via le lien ci-dessus. Le catalogue peut être publié après GitHub ; s'il n'affiche pas encore la version actuelle, utilisez GitHub Releases ci-dessous. Il utilise la même clé de signature (SHA-256 `0be97352…f91a`), donc les mises à jour continuent sans interruption même si vous installez d'abord un APK GitHub par sideload. - **Installation directe de l'APK** : téléchargez l'APK depuis la [release GitHub v2.32.1](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1), puis exécutez-le sur votre appareil Android. -- **Google Play** : [Markleaf sur Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **les mises à jour sont en pause** (voir la note ci-dessus). Si vous l'avez déjà, elle continue de fonctionner, mais obtenez la dernière version via F-Droid, GitHub ou GitLab. +- **Google Play** : [Markleaf sur Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **les mises à jour sont en pause** (voir la note ci-dessus). Si vous l'avez déjà, elle continue de fonctionner ; obtenez la version actuelle via GitHub Releases ou via F-Droid une fois publiée. ### Compilation depuis les sources Si vous souhaitez compiler le projet ou contribuer, suivez ces étapes. diff --git a/README.ja.md b/README.ja.md index 2fc4f5d8..18285950 100644 --- a/README.ja.md +++ b/README.ja.md @@ -34,7 +34,7 @@

GitHub リポジトリ · Discussions（フィードバック） · - GitLab 公開ミラー + GitLab ソースミラー

@@ -163,11 +163,11 @@ com.markleaf.notes ### インストール方法 > [!NOTE] -> **現在、Google Play での更新は一時保留中です。** 個人開発者の韓国の事業者登録に関するポリシー要件が解決するまで、新しいバージョンは Play ストアに公開しません。その間は **最新版を F-Droid、GitHub Releases、または GitLab Releases から入手してください。**（すでに Play ストアからインストール済みの場合はそのまま使えます。） +> **現在、Google Play での更新は一時保留中です。** 個人開発者の韓国の事業者登録に関するポリシー要件が解決するまで、新しいバージョンは Play ストアに公開しません。最新リリースは **GitHub Releases** から入手してください。F-Droid のビルドが追いついた後は、F-Droid が推奨の更新経路です。（すでに Play ストアからインストール済みの場合はそのまま使えます。） -- **F-Droid** *(推奨)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — F-Droid クライアントで検索するか、上のリンクから直接インストールできます。同じ署名鍵（SHA-256 `0be97352…f91a`）を使用するため、GitHub/GitLab Releases の APK をサイドロードした場合でも途切れなく更新が続きます。 +- **F-Droid** *(自動更新に推奨)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — F-Droid クライアントで検索するか、上のリンクから直接インストールできます。カタログへの公開は GitHub より遅れることがあるため、最新版がまだ表示されない場合は下の GitHub Releases を使ってください。同じ署名鍵（SHA-256 `0be97352…f91a`）を使用するため、最初に GitHub の APK をサイドロードしても更新は継続します。 - **APK の直接インストール**: [GitHub v2.32.1](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1) リリースから APK をダウンロードし、Android 端末で実行してインストールします。 -- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **更新は一時保留中**です（上の注記を参照）。すでにインストール済みなら引き続き使えますが、最新版は F-Droid・GitHub・GitLab から入手してください。 +- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **更新は一時保留中**です（上の注記を参照）。すでにインストール済みなら引き続き使えます。最新版は GitHub Releases、または反映後の F-Droid から入手してください。 ### 開発環境の構築 自分でビルドしたり貢献したい場合は、次の手順に従ってください。 diff --git a/README.ko.md b/README.ko.md index 0539f8f8..58884571 100644 --- a/README.ko.md +++ b/README.ko.md @@ -34,7 +34,7 @@

GitHub 저장소 · Discussions (피드백) · - GitLab 공개 미러 + GitLab 소스 미러

@@ -163,11 +163,11 @@ com.markleaf.notes ### 설치 방법 > [!NOTE] -> **Google Play 업데이트는 현재 잠정 보류 중입니다.** 1인 개발자의 한국 사업자 등록 요건 관련 정책 이슈가 정리될 때까지 새 버전을 Play Store에 올리지 않습니다. 그동안 **최신 버전은 F-Droid, GitHub Releases 또는 GitLab Releases에서 받아 주세요.** (Play Store에 이미 설치돼 있다면 그대로 사용할 수 있습니다.) +> **Google Play 업데이트는 현재 잠정 보류 중입니다.** 1인 개발자의 한국 사업자 등록 요건 관련 정책 이슈가 정리될 때까지 새 버전을 Play Store에 올리지 않습니다. 최신 버전은 **GitHub Releases**에서 받으세요. F-Droid 빌드가 따라온 뒤에는 F-Droid가 권장 업데이트 경로입니다. (Play Store에 이미 설치돼 있다면 그대로 사용할 수 있습니다.) -- **F-Droid** *(권장)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — F-Droid 클라이언트에서 검색하거나 위 링크로 바로 설치할 수 있습니다. 동일 서명 키(SHA-256 `0be97352…f91a`)를 사용하므로 GitHub/GitLab Releases APK로 사이드로드한 경우에도 끊김 없이 업데이트가 이어집니다. +- **F-Droid** *(자동 업데이트용 권장)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — F-Droid 클라이언트에서 검색하거나 위 링크로 바로 설치할 수 있습니다. 카탈로그 반영은 GitHub보다 늦을 수 있으므로, 아직 최신 버전이 보이지 않으면 아래 GitHub Releases를 사용하세요. 동일 서명 키(SHA-256 `0be97352…f91a`)를 사용하므로 처음 GitHub APK를 사이드로드했어도 업데이트가 이어집니다. - **APK 직접 설치**: [GitHub v2.32.1](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1) 릴리스에서 APK를 다운로드한 뒤 Android 기기에서 실행해 설치합니다. -- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **업데이트 잠정 보류 중**입니다(위 안내 참고). 이미 설치돼 있으면 계속 쓸 수 있지만, 최신 버전은 F-Droid·GitHub·GitLab에서 받으세요. +- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **업데이트 잠정 보류 중**입니다(위 안내 참고). 이미 설치돼 있으면 계속 쓸 수 있으며, 최신 버전은 GitHub Releases 또는 반영이 끝난 F-Droid에서 받으세요. ### 개발 환경 구축 직접 빌드하거나 기여하고 싶다면 다음 과정을 따르세요. diff --git a/README.md b/README.md index c6c07ac4..84c09934 100644 --- a/README.md +++ b/README.md @@ -34,7 +34,7 @@

GitHub repository · Discussions (feedback) · - GitLab public mirror + GitLab source mirror

@@ -163,11 +163,11 @@ com.markleaf.notes ### Installation > [!NOTE] -> **Google Play updates are currently on hold.** New versions won't be pushed to the Play Store until a Korean business-registration policy requirement for the solo developer is resolved. In the meantime, **get the latest version from F-Droid, GitHub Releases, or GitLab Releases.** (If you already installed it from the Play Store, it keeps working.) +> **Google Play updates are currently on hold.** New versions won't be pushed to the Play Store until a Korean business-registration policy requirement for the solo developer is resolved. For the current release, use **GitHub Releases**. F-Droid remains the recommended update path when its build has caught up. (If you already installed it from the Play Store, it keeps working.) -- **F-Droid** *(recommended)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — search in the F-Droid client or install via the link above. It uses the same signing key (SHA-256 `0be97352…f91a`), so updates continue seamlessly even if you sideloaded an APK from GitHub or GitLab Releases. +- **F-Droid** *(recommended for automatic updates)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — search in the F-Droid client or install via the link above. Its catalog may publish after GitHub; if it does not yet show the current version, use GitHub Releases below. It uses the same signing key (SHA-256 `0be97352…f91a`), so updates continue seamlessly even if you first sideload a GitHub APK. - **Direct APK install**: download the APK from the [GitHub v2.32.1 release](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1), then run it on your Android device. -- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **updates are paused** (see the note above). If you already have it, it keeps working, but get the latest version from F-Droid, GitHub, or GitLab. +- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **updates are paused** (see the note above). If you already have it, it keeps working; use GitHub Releases for the current version or F-Droid once it is available there. ### Building from source If you'd like to build or contribute, follow these steps. diff --git a/docs/COMMERCIAL_READINESS_PLAN.md b/docs/COMMERCIAL_READINESS_PLAN.md index 166811d1..5188b97b 100644 --- a/docs/COMMERCIAL_READINESS_PLAN.md +++ b/docs/COMMERCIAL_READINESS_PLAN.md @@ -2,9 +2,13 @@ 이 문서는 Markleaf를 MVP 이후의 "기능 구현 완료 앱"에서 Play 정식 출시와 장기 사용자 데이터 보관에 견딜 수 있는 상용 수준 앱으로 끌어올리기 위한 실행 계획이다. -작성 기준일: 2026-05-14 -현재 기준 버전: v2.14.0 -핵심 판단: 기능 완성도는 높지만, 상용화 전에는 데이터 보호, 릴리즈 게이트, 개인정보 문서, 동기화 장애 가시성을 먼저 닫아야 한다. +원본 작성 기준일: 2026-05-14 +원본 기준 버전: v2.14.0 + +상태 검토: 2026-07-28, v2.32.1. 이 문서의 P0–P2 항목은 완료 이력으로 보존한다. 현재의 +우선순위는 새 상용 기능이 아니라 안정적인 최신 배포, F-Droid 반영, 반복 사용자 피드백, 그리고 +지속 가능한 유지보수 비용이다. 실행 중인 운영 계획과 중단 기준은 +[`docs/ROADMAP.md`](ROADMAP.md)의 **안정성, 배포, 사용자 증거** 섹션을 따른다. ## 1. 냉정 평가 diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 93778b63..96550ae4 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -194,10 +194,52 @@ v2.0–v2.22에서 Bear급 경험을 위한 기능 기반과 Android 플랫폼 --- -## v2.23+ — Bear-class 제품 응집도 (계획) +## 2026-07–10 — 안정성, 배포, 사용자 증거 (현재 우선순위) + +기준일: 2026-07-28, v2.32.1 + +v2.23 이후 Quiet Editor, 온보딩, 잠금, 동기화 신뢰성, 노트 탐색과 공개 표면을 계속 +다듬었다. 이 시점의 병목은 기능 수가 아니라 **신뢰할 수 있는 배포 경로와 반복 사용자의 +증거**다. 따라서 아래 기간에는 새 대형 기능을 기본값으로 추가하지 않는다. + +제품 계약: + +- Markleaf는 **평면 폴더에서 쓰는 Android 로컬 우선 Markdown 메모 앱**이다. 중첩 폴더와 + 파일명 기반 링크가 많은 기존 vault의 완전한 대체재로 약속하지 않는다. +- 최신 signed APK의 기준점은 GitHub Releases다. F-Droid는 자동 업데이트에 권장하지만 + 카탈로그 반영은 GitHub보다 늦을 수 있다. GitLab은 소스 미러이며, 릴리스 자산의 가용성을 + 사용자 설치 경로로 약속하지 않는다. Google Play 업데이트는 정책 문제가 해결될 때까지 보류한다. +- 새 기능은 실제 사용자 피드백, 데이터 안전성, Android 호환성 문제 중 하나를 직접 해결할 때만 + 이 기간에 들어온다. + +작업: + +- GitHub, F-Droid, Google Play, GitLab의 역할과 최신 버전 안내를 README 6개 언어에서 같은 + 문구로 유지한다. +- GitLab 릴리스 자산 게시 실패를 복구하거나, 복구 전까지 그 채널을 설치 안내에서 제외한다. +- 서로 다른 폴더 동기화 도구와 실제 Markdown 폴더를 쓰는 테스터 5–10명에게 편집·동기화·복구 + 흐름을 검증받는다. +- 공개 Discussions/이슈에서 설치 경로, 앱 버전, 재현 단계만 받는 가벼운 피드백 흐름을 유지한다. + 앱 내 분석·추적·계정은 추가하지 않는다. +- 배포와 핵심 테스트가 안정될 때까지 정식 릴리스를 2–4주 단위로 묶고, 긴급 데이터 손실 수정만 + 예외로 한다. + +판단 게이트: + +- 3개월 안에 서로 다른 사용자에게서 재현 가능한 피드백 10건 이상과 반복 사용자 신호가 쌓이면, + 가장 큰 동기화·온보딩 문제를 다음 한 사이클의 후보로 고른다. +- 6개월 동안 피드백과 설치 경로의 성장 증거가 없거나 유지보수 부담이 주당 약 4시간을 넘으면, + 기능 개발을 멈추고 Android 호환성·보안·데이터 안전성만 다루는 유지보수 모드로 전환한다. + +--- + +## v2.23+ — 기능 백로그 (보류) 기준일: 2026-07-15, v2.22.0 +아래 Phase 29–33은 당시의 기능 제안이다. 버전 번호나 구현 약속으로 해석하지 않으며, +위 안정성·배포·사용자 증거 게이트를 통과한 뒤에만 다시 우선순위를 매긴다. + Markleaf는 이미 라이브 Markdown, 표, 이미지, 위키링크·백링크, Quick Insert, 전문 검색, 폴더 미러, PDF, 위젯까지 갖췄다. 다음 단계의 목표는 기능 수를 늘리는 것이 아니라 다음 세 흐름을 하나의 조용한 제품 경험으로 묶는 것이다.