Skip to content

Architecture (manual) merge into dev#1499

Merged
demiankatz merged 20 commits into
devfrom
architecture
Jul 17, 2025
Merged

Architecture (manual) merge into dev#1499
demiankatz merged 20 commits into
devfrom
architecture

Conversation

@LlGC-jop

Copy link
Copy Markdown
Contributor

Merges the architecture branch into dev so that the manual can be updated continuously as work on other issues takes place, or when and if someone has time to add to it.

@vercel

vercel Bot commented Jul 15, 2025

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
universalviewer ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 17, 2025 1:38pm

@LlGC-jop LlGC-jop requested a review from demiankatz July 15, 2025 14:52
@LlGC-jop

Copy link
Copy Markdown
Contributor Author

The new architecture diagram is still a WIP, mostly in miro, and some sketches I need to add to it. Will add in a future PR to dev.

@demiankatz demiankatz left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @LlGC-jop, this is off to a good start. See below for minor suggestions and corrections. I confess that I was more focused on general organizational issues than the actual accuracy of the content, so apologies if I've missed the trees for the forest, as it were. ;-)

Comment thread manual/MANUAL.md Outdated
Comment thread manual/ARCHITECTURE.md
Comment thread manual/EVENTS.md Outdated
Comment thread manual/EVENTS.md
Events are subscribed to by using uv.on("event", handler) , where uv is an instance returned by UV.init("id", data) . See this example in the embed HTML.

<!-- omit in toc -->
### CONFIGURE

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should these events be one heading level deeper than "Descriptions" or are they meant to be at the same level?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure what the intent was, I think I must have copied everything from Geoff's document I think?

Either way, I'll make a bulleted intro summary to match the formatting in other docs, so it's consistent.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Something weird is going on, because the CONFIGURE event is indented at a different level from all subsequent events. I can't see an obvious reason for this in the code, though!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if making the TODO block above into another subheading/bulleted list will have any useful effect....

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll try copying the text into notepad and then back in. If I copied it from Google docs there might be some invisible formatting going on.

@LlGC-jop LlGC-jop Jul 17, 2025

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It was the <object> part, must have confused the parser. Have made <> html entities.

Comment thread manual/EVENTS.md Outdated
Comment thread manual/EXECUTION.md Outdated
Comment thread manual/EXECUTION.md Outdated
Comment thread manual/EXECUTION.md Outdated
Comment thread manual/EXECUTION.md Outdated

@demiankatz demiankatz left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @LlGC-jop, I think this is in great shape and we should be able to merge it soon. I'd just like to see if we can figure out the unexpected behavior of the events outline first....

demiankatz
demiankatz previously approved these changes Jul 17, 2025

@demiankatz demiankatz left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Excellent, the latest formatting fix seems to have sorted things out. I have no objection to merging this now -- it's a good foundation to continue building upon.

@demiankatz

Copy link
Copy Markdown
Contributor

One suggested follow-up action: we should also link to the manual from the top-level README to make this more accessible.

@demiankatz demiankatz left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the finishing touches, @LlGC-jop. Merging now!

@demiankatz demiankatz merged commit cd9151e into dev Jul 17, 2025
6 checks passed
@demiankatz demiankatz deleted the architecture branch July 17, 2025 14:02
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.

3 participants