From bca74ce1f1227ad157dddd36f16a6e024baf4015 Mon Sep 17 00:00:00 2001 From: r4bbit <445106+0x-r4bbit@users.noreply.github.com> Date: Mon, 2 Dec 2024 11:58:06 +0100 Subject: [PATCH] docs(system-overview.md): add system overview docs This commit introduces the first documentation which provides an overview of the staking system and how accounts will interact with it. Closes #30 --- docs/assets/overview.png | Bin 0 -> 554699 bytes docs/system-overview.md | 47 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 47 insertions(+) create mode 100644 docs/assets/overview.png create mode 100644 docs/system-overview.md diff --git a/docs/assets/overview.png b/docs/assets/overview.png new file mode 100644 index 0000000000000000000000000000000000000000..6897dd48d711cec050a2c41b83c76476f506ce00 GIT binary patch literal 554699 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