Skip to content

docs: align README with org template + Mermaid architecture diagram#4

Open
willwade wants to merge 2 commits into
mainfrom
docs/readme-tidy
Open

docs: align README with org template + Mermaid architecture diagram#4
willwade wants to merge 2 commits into
mainfrom
docs/readme-tidy

Conversation

@willwade

Copy link
Copy Markdown
Contributor

Brings the Android README in line with the .github README-TEMPLATE, matching what Dasher-Windows and the other frontends already do.

Changes

  • Architecture diagram is now Mermaid (graph LR + subgraphs) instead of the one-line ASCII arrow — renders on GitHub, same style as Dasher-Windows's. Shows the Compose app + IME → JNI shim → DasherCore CAPI flow, the int[] command buffer return path, and the engine callbacks (clipboard/speak/message/output/log).
  • Structure now follows the org template: badges, standard two-sentence Dasher intro, dasher.at / feature-status / repos block, Status / Install / Build / Architecture / Repository layout / Contributing / License.
  • Status updated from the stale "Phase 0 (foundation scaffold)" to Preview, with the honest "not on Play Store yet — sideload from Releases" note.
  • Repository layout corrected to the real at.dasher.android package (it referenced the old org.dasherproject.android path) and the current file set (NativeBridge, DasherEngine, DasherImeService, SettingsScreen, AnalyticsService, DasherApp, LocaleHelper, ui/, etc.); converted from an ASCII tree to a table.
  • Build section is now copy-pasteable: git clone --recurse-submodules + ./gradlew :app:assembleDebug.

No code changes; docs only.
DCO: commit is Signed-off-by.

willwade added 2 commits June 29, 2026 01:02
Bring the README in line with the .github README-TEMPLATE structure used by
the other Dasher frontends (Dasher-Windows et al.): standard two-sentence
intro, dasher.at/feature-status/repos block, Build/Release/License badges,
Status, Install, Build, Architecture, Repository layout, Contributing, License.

- Architecture diagram is now a Mermaid graph (graph LR + subgraphs) instead
  of the one-line ASCII arrow, matching the other frontends and rendering on
  GitHub. Shows the Compose app + IME -> JNI shim -> DasherCore CAPI flow and
  the command-buffer + engine-callback return paths.
- Status updated from the stale Phase 0/scaffold line to Preview, with the
  Play-Store-not-yet + sideload-from-Releases reality.
- Repository layout converted to a table and corrected to the real
  at.dasher.android package (was the old org.dasherproject path) and current
  files (NativeBridge, DasherEngine, DasherImeService, SettingsScreen,
  AnalyticsService, DasherApp, LocaleHelper, ui/, etc.).
- Build section now copy-pasteable (clone --recurse + gradlew assembleDebug).

Signed-off-by: will wade <willwade@gmail.com>
'int[6]' inside a node label broke Mermaid - '[' starts a node shape. Quote
all node labels, reword the canvas node to 'decodes the 6-int command buffer'
(no brackets/arrow), and quote the draw-commands edge label.

Signed-off-by: will wade <willwade@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant