halkyon/docs/adr
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Tizian 「ティツィアーン」 5efa552489
feat(discussions): questions on published studysets, answered by learners
A learner asks about a published studyset, a topic in it, or one card,
note or step of a release, and others answer, as on Stack Exchange
(ADR 0013): questions and answers in the app's editor without images,
sounds or videos, comments of up to 600 characters under the question
and each answer. There are no votes: the asker accepts an answer, which
comes first, then the oldest; the author's posts are marked. The
instance reads from git's file list which topics a question's target
sits in, so a topic lists what is asked within it and below it.

Posts live in two server-only tables, written through endpoints, so the
synced tables stay as they are and v0.17.0 keeps syncing. Everyone
signed in reads; writing needs an identity and a public profile; the
studyset's author hides posts and blocks people with feedback's blocks;
a withdrawn studyset takes no new questions; anyone writes at most 30
posts an hour. A post with others' replies under it is emptied when
deleted, else deleted; deletePerson deletes what a person wrote the same
way, and a published studyset's deletion takes its discussions with it.

The migration adds Serverpod's gen_random_uuid_v7(), discussion_post
and discussion_seen with their indexes and cascading foreign keys, and
changes nothing else.

In the app, discussions open from a copy's studyset or topic menu, a
studied card's "Ask about this", Explore's summary and the Publish
sheet; the Profile tab's inbox lists those the person follows, and its
count includes what is new in them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me>
2026-10-17 19:46:32 +02:00
..
0001-offline-sync.md docs: ADR 0001's spike is kept by its developer, not published 2026-10-14 16:10:05 +02:00
0002-no-end-to-end-encryption.md docs(adr): 0002 no end-to-end encryption 2026-09-29 22:19:08 +02:00
0003-card-revisions.md feat(app): card types, whose fields merge separately 2026-10-01 21:10:02 +02:00
0004-tree-tags-review-modes-settings-assets.md feat(app): write kanji, kana and words by hand, each stroke checked 2026-10-09 18:09:34 +02:00
0005-public-tier.md feat(feedback): report, suggest, and an inbox in the Profile tab 2026-10-10 09:46:43 +02:00
0006-assistant-connector.md feat(assistant): Claude reads studysets through a connector on the instance 2026-10-10 15:11:17 +02:00
0007-recently-deleted.md feat(studyset): deleted studysets wait 14 days in Recently deleted 2026-10-13 21:21:43 +02:00
0008-languages-beyond-japanese.md docs: ADR 0008 with the sizes and times measured on the real data 2026-10-14 09:39:31 +02:00
0009-language-parity.md docs: ADR 0009, feature parity for the other languages 2026-10-14 14:35:35 +02:00
0010-email-sign-in.md feat(auth): codes go by mail, through the SMTP service an instance sets up 2026-10-17 19:46:28 +02:00
0011-profile-pages-and-verified-links.md feat(profile): profile pages on the account domain, and links verified by rel="me" 2026-10-17 19:46:29 +02:00
0012-japanese-on-the-device.md feat(dictionary): Japanese cut into words and looked up on the device 2026-10-17 19:46:30 +02:00
0013-discussions.md feat(discussions): questions on published studysets, answered by learners 2026-10-17 19:46:32 +02:00