Thanks to visit codestin.com
Credit goes to github.com

Skip to content

General text trimming#4

Draft
dolanske wants to merge 4 commits into
hivecom:mainfrom
dolanske:trimdown
Draft

General text trimming#4
dolanske wants to merge 4 commits into
hivecom:mainfrom
dolanske:trimdown

Conversation

@dolanske

@dolanske dolanske commented Jun 15, 2026

Copy link
Copy Markdown
Member

As I read the document, I change, trim or edit sections which I think should be simplified. However I think that not all edits I do might be beneficial and could be done better. Treat this PR as a suggestion then. Edits and comments are more than welcome!

Comment thread spec/01-architecture/01-overview.md

### Uplink

Uplink is the IRC layer of an Orbit deployment - an adopted role, not software Orbit builds. Uplink is any stock IRCv3 server; [Ergo](https://ergo.chat/) is the reference implementation, run with no Orbit-specific patches. All persistent communication - messages, channel membership, message history, user identity - flows through Uplink. It is a standard IRCv3 server: no Orbit-specific plugins, no knowledge of Satellite or Depot at the protocol level. Orbit clients and plain IRC clients connect identically. There is no Uplink fork; Orbit runs the server stock and conforms to IRCv3, supporting whatever stock Ergo implements.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This is a fairly important line that it's dropping. I'd at least keep the fact that Orbit and normal IRC clients live alongside each other.

## What IRC Clients Can Do That Orbit Clients Do

Everything IRC does well: text chat, channel modes, SASL auth, DMs, bots, ZNC/bouncer support, scripting. An IRC client connecting to Uplink is a first-class participant in the text layer. The spec does not treat IRC clients as second-class.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Why would we drop this section? It's fairly important to state the limitations between the clients and make it clear which capabilities are still shared, making existing IRC clients lightweight Orbit clients by default.

@zealsprince zealsprince left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Have a few notes for now - otherwise I'm fine with slimming down and trimming line-ending fluff. I was doing a lot of it as opinionated statements trying to drive points home but in your diff I'm realizing I'm doing it more than I remembered.

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.

2 participants