[DESIGN] Overview diagram: Yonatan's layout in the archify style - #94
Merged
Conversation
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
haimbj1
force-pushed
the
docs/overview-diagram
branch
from
September 10, 2026 07:18
51f6fc2 to
764146c
Compare
haimbj1
force-pushed
the
docs/overview-diagram
branch
from
September 10, 2026 07:45
8267f95 to
3356fd1
Compare
haimbj1
marked this pull request as ready for review
September 14, 2026 11:55
haimbj1
added a commit
that referenced
this pull request
Sep 14, 2026
* [DOCS] encryption flow: designed diagram, colour marks where each component runs * [DOCS] encryption flow: SVG uses the blueprint palette, matching the explorable page * [DOCS] style/diagrams: colour marks the zone a component runs in, across every diagram * [DOCS] style/diagrams: colour table covers the eight columns, CT Server explained * [DOCS] encryption flow: SVG ground follows the preset, embed drops its frame * [DOCS] encryption flow: Runs in column decodes the diagram colour * [DOCS] style/diagrams: the Runs in column is the colour legend * [DOCS] deep-dive: designed diagrams and explorable pages for the five Tier 1 flows * [DOCS] zk-verifier: split the zone tip into shorter sentences * [DOCS] diagrams: keep the legend clear of the last segment band * [DOCS] diagrams: arrows land on the lifeline, or on the activation bar * [DOCS] intro pages: designed diagrams with the CoFHE column in the offchain colour * [DOCS] tier 3: designed diagrams for key management, the pipeline and the version lifecycle * [DOCS] diagrams: legends name zones and states, not renderer internals * [DOCS] key-management: name the consumers and cofhe-keys, so the diagram and page agree * [DOCS] use American spelling for color, matching the rest of the site * [DOCS] diagrams: crop each SVG to its own content, top and bottom * [DOCS] introduction/what-is-cofhe: component table matches the diagram vocabulary * [DOCS] cofhe-components/key-management: align the mmd source and the tip with the designed diagram * [DOCS] cofhe-components/teecryptor: the coprocessor stores the bytes, not the FHE Engine * [DOCS] data-flows/encryption-request-flow: CT Server is not drawn in the designed diagram * [DOCS] introduction/mental-model: canonical coprocessor spelling, sentence-case headings * [DESIGN] Overview diagram: Yonatan's layout in the archify style (#94) * [DOCS] overview: Yonatan's layout and wording in the archify style * [DOCS] overview: open the layout up, pipeline in one row * [DOCS] overview: 2x2 blocks, and crop every diagram to its content * [DOCS] overview: three wide columns, every component keeps its description * [DOCS] diagrams: description in its own band, frames colored by group * [DOCS] diagrams: ground follows the crop, overview in a wider ratio * [DOCS] diagrams: fill the frame instead of letterboxing inside it * [DOCS] overview: partners release to both TEEs, drawn as a stack * [DOCS] diagrams: new house palette, solid headline bands, registry to the right * [DOCS] diagrams: crop the sides, space the frames, palette in the explorable pages * [DOCS] diagrams: declare a width past the column so they fill the frame * [DOCS] overview: ACL beside PlaintextsStorage, white names on the blue accent * [DOCS] overview: left to right, host chain left, CoFHE middle, registry right * [DOCS] overview: one packed grid, aligned frames, pipeline as one component
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A dedicated commit so the overview can be judged on its own, separate from #93.
Takes Yonatan's board (Figma node 44:3559) and rebuilds it with the color scheme and export pipeline the other eleven diagrams use.
Kept from his board
.solsuffix per STYLE.md, "Securely authorizes" loses the adjective, and the Client SDK no longer claims to decryptChanged
export-svg.pyKnown rough edges, worth a look before merging
Three components have no connections. Client SDK, Ciphertext store and ZK Verifier sit in their zones without edges. Adding them crossed other nodes, and the validator rejects that.
The pipeline does not read continuously. Slim listener and FheOS are on one row, FHE Engine and Blockchain poster on the next, and the FheOS to FHE Engine link is missing, so the four-stage order is not visible.
Sublabels are much shorter than his. Archify sublabels are a single line, and desktop readability caps the viewBox at about 1023px, which caps sublabel width. The full descriptions live in the page's component lists directly below the diagram.
The option worth considering
Dropping sublabels entirely would lift the width cap, allowing five or six columns and the pipeline in a single row, which fixes the reading order. The page already describes every component underneath, so little would be lost. Say the word and I will build that variant to compare.