"One of the most important events is the focus change. FIXME document here what needs to happen when focus changes."

Linux desktop internals documentation is just the best (this is for AT-SPI, the accessibility API, by the way)