Bug 1621950 - fix some myst ref warnings...

# Architecture

This document provides a high-level overview of how the accessibility code is structured. See [the Document Accessibility Lifecycle page](/accessible/DocumentAccessibilityLifecycle.html#docaccessible-creation) for a lower level description of the code.

This document provides a high-level overview of how the accessibility code is structured. See [the Document Accessibility Lifecycle page](DocumentAccessibilityLifecycle.md#docaccessible-creation) for a lower level description of the code.

## Process Model

The accessibility component spans multiple processes. In the parent process, it creates an accessibility tree of the Firefox UI and responds to requests from screen readers. In content processes, the accessibility component creates accessibility trees from web content.

* [topFrecentSites](#topfrecentsites)

* [totalBookmarksCount](#totalbookmarkscount)

* [usesFirefoxSync](#usesfirefoxsync)

* [isFxAEnabled](#isFxAEnabled)

* [isFxASignedIn](#isFxASignedIn)

* [isFxAEnabled](#isfxaenabled)

* [isFxASignedIn](#isfxasignedin)

* [creditCardsSaved](#creditcardssaved)

* [addressesSaved](#addressessaved)

* [xpinstallEnabled](#xpinstallEnabled)

* [xpinstallEnabled](#xpinstallenabled)

* [hasPinnedTabs](#haspinnedtabs)

* [hasAccessedFxAPanel](#hasaccessedfxapanel)

* [isWhatsNewPanelEnabled](#iswhatsnewpanelenabled)

* [doesAppNeedPrivatePin](#doesappneedprivatepin)

* [isBackgroundTaskMode](#isbackgroundtaskmode)

* [backgroundTaskName](#backgroundtaskname)

* [userPrefersReducedMotion](#userPrefersReducedMotion)

* [colorwaysActive](#colorwaysActive)

* [userEnabledActiveColorway](#userEnabledActiveColorway)

* [inMr2022Holdback](#inMr2022Holdback)

* [distributionId](#distributionId)

* [fxViewButtonAreaType](#fxViewButtonAreaType)

* [userPrefersReducedMotion](#userprefersreducedmotion)

* [colorwaysActive](#colorwaysactive)

* [userEnabledActiveColorway](#userenabledactivecolorway)

* [inMr2022Holdback](#inmr2022holdback)

* [distributionId](#distributionid)

* [fxViewButtonAreaType](#fxviewbuttonareatype)

## Detailed usage

where *getter* and *setter* are grips on the property's getter and setter functions. These may be `{ "type":"undefined" }` if the property lacks the given accessor function.

A **safe getter value descriptor** provides a value that an inherited accessor returned when applied to an instance. (See [Finding An Object's Prototype And Properties](#finding-an-objects-prototype-and-properties) for an explanation of why and when such descriptors are used.) Such a descriptor has the form:

A **safe getter value descriptor** provides a value that an inherited accessor returned when applied to an instance. (See [Finding An Object's Prototype And Properties](#finding-an-object-s-prototype-and-properties) for an explanation of why and when such descriptors are used.) Such a descriptor has the form:

```

{ "getterValue": <value>, "getterPrototypeLevel": <level>,

{ "type":"object", "class":"Object", "actor":<actor> }

```

and sending a ["prototypeAndProperties"](#finding-an-objects-prototype-and-properties) request to *actor* would produce the following reply:

and sending a ["prototypeAndProperties"](#finding-an-object-s-prototype-and-properties) request to *actor* would produce the following reply:

```

{ "from":<actor>, "prototype":{ "type":"object", "class":"Object", "actor":<objprotoActor> },

```

Sending a ["prototypeAndProperties"](#finding-an-objects-prototype-and-properties) request to an object actor referring to a DOM mouse event might produce the following reply:

Sending a ["prototypeAndProperties"](#finding-an-object-s-prototype-and-properties) request to an object actor referring to a DOM mouse event might produce the following reply:

```

{ "from":<mouseEventActor>, "prototype":{ "type":"object", "class":"MouseEvent", "actor":<mouseEventProtoActor> },

* Test changes:

  * The feature or bug is [tested by new tests, or a modification of existing tests](../tests/writing-tests.md).

  * [Test logging](../tests/writing-tests.md#logs-and-comments) is sufficient to help investigating test failures/timeouts.

  * [Test is e10s compliant](../tests/writing-tests.md#e10s-electrolysis) (doesn't try to access web content from the parent process, etc…).

  * [Test is e10s compliant](../tests/writing-tests.md#electrolysis) (doesn't try to access web content from the parent process, etc…).

  * Tests are [clean and maintainable](../tests/writing-tests.md#writing-clean-maintainable-test-code).

  * A try push has started (or even better, is green already).

* User facing changes:

  * If any user-facing interfaces are added/modified, double-check the changes with the UX mockups or specs, if available. If there's any confusion, need-info the UX designer.<!--TODO this needs updating with the new process-->

  * If a user facing string has been added, it is localized and follows [the localization guidelines](../files/adding-files.html#localization-l10n).

  * If a user facing string has been added, it is localized and follows [the localization guidelines](../files/adding-files.md#localization-l10n).

  * If a user-facing string has changed meaning, [the key has been updated](https://mozilla-l10n.github.io/documentation/localization/making_string_changes.html).

  * If a new image is added, it is a SVG image or there is a reason for not using a SVG.

  * If a SVG is added/modified, it follows [the SVG guidelines](../frontend/svgs.md).

## Profile Guided Optimization (PGO)

[Profile Guided

Optimization](/build/buildsystem/pgo.html#profile-guided-optimization) is

Optimization](/build/buildsystem/pgo.rst#profile-guided-optimization) is

disabled by default and may improve runtime by up to 20%. However, it takes a

long time to build. To enable, add the following to your [mozconfig]:

```

Zoom](http://www.rotateright.com/) on Linux (uses perf underneath), and

Intel VTune on Windows or Linux.

[mozconfig]: /setup/configuring_build_options.html#using-a-mozconfig-configuration-file

[mozconfig]: /setup/configuring_build_options.rst#using-a-mozconfig-configuration-file