Skip to content
This repository was archived by the owner on Apr 26, 2024. It is now read-only.

Commit 885a880

Browse files
committed
Wrap lines
1 parent abe66d1 commit 885a880

File tree

1 file changed

+14
-10
lines changed

1 file changed

+14
-10
lines changed

docs/development/room-dag-concepts.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,9 @@ A (oldest) <---- B <---- C (most recent)
1313

1414
## Depth and stream ordering
1515

16-
Events are sorted by `(topological_ordering, stream_ordering)` where `topological_ordering` is just `depth`. Normally, `stream_ordering` is an auto incrementing integer but for `backfilled=true` events, it decrements.
16+
Events are sorted by `(topological_ordering, stream_ordering)` where
17+
`topological_ordering` is just `depth`. Normally, `stream_ordering` is an auto
18+
incrementing integer but for `backfilled=true` events, it decrements.
1719

1820
`depth` is not re-calculated when messages are inserted into the DAG.
1921

@@ -33,27 +35,29 @@ A backwards extremity is a place where the oldest-in-time events of the DAG
3335

3436
This is an event where we haven't fetched all of the `prev_events` for.
3537

36-
Once we have fetched all of it's `prev_events`, it's unmarked as backwards extremity
37-
and those `prev_events` become the new backwards extremities.
38+
Once we have fetched all of it's `prev_events`, it's unmarked as backwards
39+
extremity and those `prev_events` become the new backwards extremities.
3840

3941

4042
## Outliers
4143

4244
We mark an event as an `outlier` when we haven't figured out the state for the
4345
room at that point in the DAG yet.
4446

45-
We won't *necessarily* have the `prev_events` of an `outlier` in the database, but it's entirely possible that we *might*. The status of whether we have all of the `prev_events` is marked as
46-
a [backwards extremity](#backwards-extremity).
47+
We won't *necessarily* have the `prev_events` of an `outlier` in the database,
48+
but it's entirely possible that we *might*. The status of whether we have all of
49+
the `prev_events` is marked as a [backwards extremity](#backwards-extremity).
4750

48-
For example, when we fetch the event auth chain or state for a given event, we mark all of those
49-
claimed auth events as outliers because we haven't done the state calculation ourself.
51+
For example, when we fetch the event auth chain or state for a given event, we
52+
mark all of those claimed auth events as outliers because we haven't done the
53+
state calculation ourself.
5054

5155

5256
### Floating outlier
5357

54-
A floating `outlier` is an arbitrary floating event in the DAG (as opposed to being
55-
inline with the current DAG). This happens when it the event doesn't have any `prev_events`
56-
or fake `prev_events` that don't exist.
58+
A floating `outlier` is an arbitrary floating event in the DAG (as opposed to
59+
being inline with the current DAG). This happens when it the event doesn't have
60+
any `prev_events` or fake `prev_events` that don't exist.
5761

5862

5963
## State groups

0 commit comments

Comments
 (0)