Glossary

Glossary

This wiki follows ASD-STE100 (Simplified Technical English). ASD-STE100 permits technical names and technical verbs that a document defines. This page gives the technical names of Rambla. Each name has one meaning in this wiki.

Technical names

Name	Meaning
mutation	An operation that changes the value of a property. Your code does this.
notification	A PropertyChanged or CollectionChanged event. Rambla raises it.
flush	One pass that raises the notifications for all the dirty properties.
dirty property	A property with a new value that Rambla did not yet notify.
to coalesce	To replace two or more mutations of one property with one notification. Only the last value stays.
coalescing ratio	The fraction of the mutations that did not become notifications.
scheduler	An IStateScheduler. It moves a flush to the UI thread.
to post	To give a flush to the scheduler. The scheduler runs the flush immediately or later.
batch	The mutations between BeginUpdate() and the disposal of its scope.
notification coherence	The condition in which no observer sees a batch in a partial condition.
state atomicity	The condition in which a reader on a different thread sees all the values of a batch together. Rambla does not give this condition.
visible contents	The contents of a collection that agree with the notifications that Rambla raised.
pending target	The contents of a collection after the mutations, but before the next flush.
throttle	To limit the number of flushes in one second.
leading edge	The first post after an idle interval. The throttling scheduler releases it immediately.
run	One execution of an AsyncStateCommand.
latest-wins	The policy in which a new run cancels and replaces the run in operation.
probe	An IStateProbe. It observes mutations and flushes. It does not change the behavior.

Product names

Name	Meaning
Rambla	The core package. It has no reference to a UI framework.
Rambla.Wpf	The adapter package for WPF.
Rambla.Avalonia	The adapter package for Avalonia.
Rambla.Diagnostics	The package that measures a state.

API names

The wiki writes the API names as the code writes them. Examples are RamblaState, SetField, BeginUpdate, [State], [StateCommand], RamblaList<T>, RamblaDictionary<TKey,TValue>, ThrottlingStateScheduler, AsyncStateCommand and StateDiagnostics.