SymDiary v1.0.0

Release notes

The first release of SymDiary. It records what you observed and when, then saves
a short factual record as a PDF you can take to an appointment. It does not
diagnose, interpret or score anything.

Recording

Record a symptom in a few seconds: type what you noticed, optionally choose a
severity and add a note, then press Record now. The time is filled in for you,
so the quick path is a symptom and one key.

An occurrence you remembered later can be given its own time. What you type is
kept exactly as typed, spaces and all; nothing corrects your spelling or
rewrites your words into medical terms. A symptom you name once is offered back
next time, matched however you capitalise it, so tired finds Tired rather
than making a second one.

An occurrence cannot be dated in the future. A recording that fails to save
keeps everything you entered rather than clearing the form under you.

Looking back

The history lists your events newest first, filtered by a date range, by symptom
and by severity, with the filters combining. It shows events and counts; there
is no trend, no average, no score and no chart, because none of those would be
something you recorded.

Events can be corrected or deleted. A deletion names what will go before it
goes; it says how many when several are chosen. An edit leaves the occurrence
time alone unless you changed it, so correcting a note cannot quietly move when
something happened. A symptom can be renamed and every event using it follows.

The record you take with you

Choose a date range and SymDiary draws a document for you to save wherever you
like. It is drawn by the application itself rather than handed to the window's
browser to print, which means it reads the same whichever desktop produced it.

Every page says which page it is and how many there are; no event is ever
split across two sheets. The first line names the program and its address, with
the application's mark beside it, so a sheet lying on a desk says what produced
it. Under the date range it states plainly that the record is not a diagnosis:
it is one person's own notes, printed for a healthcare professional to read.

The document carries nothing you did not record. No printing date, no window
title and no address of its own.

Your own copy

The whole record exports to a JSON file you own; it reads back in again,
skipping anything already held so importing twice does no harm. Both dialogs
open in your Downloads folder and each asks for the kind of file it is actually
about to write.

Where it keeps things

One SQLite file, in the folder your platform keeps a program's configuration in,
with the durability settings that let an event survive a power cut a second
later. A record that cannot be opened gets a window that says so and names the
file rather than a program that never appears; the file is never overwritten.

The log holds the run's own lines and a crash. It never holds a symptom, a note
or any other part of your record; a test keeps that checkable by refusing
any new place that writes to it.

The window

It opens dark, with a button in the bar that moves it to light and remembers
which you chose. Every action is reachable from the keyboard: Tab and Right step
forward, Shift+Tab and Left step back, both wrapping. A control shows nothing at
rest, green while you are on it and red for as long as it cannot be used, so a
button you cannot press never looks like one you simply have not pressed yet.

A Guide names every control with the picture it draws. About states the version,
the author and the works SymDiary is built from. Both hold still when they open,
then read themselves down gently, stepping aside the moment you scroll.

Installing it

Windows has a setup program that is one file: it installs, updates, goes back a
version, repairs and uninstalls; it registers itself in the Apps list.
Everything it writes is yours alone, so Windows never asks for administrator
rights. Uninstalling keeps your record unless you tick the box that names it.
Before anything is installed it explains the licence in ordinary words, then
shows the full text.

Linux is a Flatpak and macOS is a signed and notarized disk image for Apple
Silicon.

What it does not do

It opens no network connection at all. No account, no cloud, no sync, no
advertising and no telemetry. The Donate button is not an exception: it hands an
address to the desktop and your own browser does the asking. On Linux the
Flatpak is granted no network permission, so there it is the sandbox enforcing
it rather than only a test.

It does not encrypt your record. The file is protected by your user account, as
your documents are.

It does not diagnose, suggest what a symptom might mean, recommend treatment,
score your health, claim two events are related or remind you to record
anything.

What this first release promises

Your exported file stays readable. Every export SymDiary has ever written will
be read by every later SymDiary, with each old version's real bytes frozen in
the test suite.

The document's wording is a public claim rather than decoration, so the line
saying the record is not a diagnosis is held by a test that asserts it whole.

What is not promised: the window's layout, the wording on screen, the log or the
setup program's screens. Those improve whenever they can.