Document what all of our "Pegs" are (just singletons) (#8510)

As discussed at https://matrix.to/#/!fLeHeojWgBGJlLNdLC:matrix.org/$DHCPeZQ1aty_1l_nNHo_5F8Uwb3t29N1zuabWa5qLzM?via=matrix.org&via=element.io&via=vector.modular.im

Peg is used in the literal sense:

> a short pin or bolt, typically tapered at one end, that is used for securing something in place, hanging things on, or marking a position.

Looking for an `MatrixClient`? Just look for the `MatrixClientPeg` on the peg board. So you'll find a `MatrixClient` hanging on the `MatrixClientPeg`.

Maybe you're more familiar with these alternative names like `MatrixClientSingleton` but that's a bit long and Java-y or `MatrixClientHandle` in the win32 world.
This commit is contained in:
Eric Eastwood 2022-05-09 21:34:27 -05:00 committed by GitHub
parent 3a241e0dfb
commit 8add540f27
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 25 additions and 5 deletions

View file

@ -29,6 +29,12 @@ import { SettingLevel } from "../settings/SettingLevel";
const INDEX_VERSION = 1;
/**
* Holds the current instance of the `EventIndex` to use across the codebase.
* Looking for an `EventIndex`? Just look for the `EventIndexPeg` on the peg
* board. "Peg" is the literal meaning of something you hang something on. So
* you'll find a `EventIndex` hanging on the `EventIndexPeg`.
*/
export class EventIndexPeg {
public index: EventIndex = null;
public error: Error = null;