Wayne Ferrao

This commit **introduces a dedicated 404 "Page Not Found" experience** for the **documentation website**. It adds a new React component, `NotFound.tsx`, responsible for rendering the page content, which includes a message and a link back to the home page. Complementary styling is provided through the new `notFound.css` file, ensuring the 404 page visually integrates with the site's existing design. This **new capability** significantly enhances user experience by gracefully handling invalid URLs within the `docs` section.

This commit **prepares the DevTools browser extension for a new release** by **bumping its manifest version** to `1.1.1`. It updates the `manifest.json` file within the `packages/tools/devtools/devtools-browser-extension` module to reflect this new version. Concurrently, the `EXTENSION_CHANGELOG.md` is updated to **document the inclusion of recent accessibility fixes** in this upcoming version. This **maintenance** task ensures proper versioning and communication of improvements for users of the **DevTools browser extension**.

This commit **adds comprehensive migration documentation** to guide developers upgrading from **Fluid version 1.x to 2.x**. It introduces a new `migration.mdx` page, integrates it into the main documentation index and sidebars, and adds a relevant FAQ entry on the support page. This **new documentation** provides critical guidance for the upgrade process, ensuring a smoother transition for users. The changes primarily affect the **documentation system**, enhancing its support for developers moving between major Fluid versions.

This commit implements an **accessibility fix** by ensuring all links within the **documentation site's main content** are consistently underlined. It **updates the CSS styling** in `docs/src/css/custom.scss`, broadening the link underlining selector from `.markdown a` to `main a`. This change resolves a minor a11y issue where links, particularly on the **Community page**, lacked visual distinction. The modification improves user experience and clarity by providing a clear visual cue for interactive elements across the site's primary content areas.

This commit provides an **accessibility bug fix** by updating the placeholder text color within the **search bar** component. It specifically modifies CSS variables in `docs/src/css/custom.scss` to ensure the placeholder text meets required contrast ratio thresholds for both light and dark themes. This **enhances user experience** for individuals with visual impairments by improving readability and adhering to accessibility standards. The change addresses a detected contrast violation, making the search bar more usable across different visual conditions.

This commit **implements a new search capability** by **integrating Typesense** into the **Docusaurus documentation website**, significantly enhancing **content discoverability and user experience**. It involves configuring the `docusaurus-theme-search-typesense` within `docs/docusaurus.config.ts` and updating `docs/README.md` with new local development instructions for the search feature. Additionally, it secures Typesense API keys and host details using environment variables, which are added to `docs/.env.template` and the `tools/pipelines/deploy-website.yml` deployment pipeline. This **new feature** provides a more robust and efficient search experience for users of the documentation.

This commit implements an **accessibility fix** by updating the color of **menu items** within the **documentation site**. It specifically modifies the `--ifm-color-primary` CSS variable in `docs/src/css/custom.scss` to a new hexadecimal value, ensuring **a11y contrast compliance** and resolving critical Sev2 warnings. This **maintenance** update significantly improves the readability and user experience for all visitors to the documentation.

This commit **removes an improper ARIA role** from the **version dropdown** component within the user interface. This is an **accessibility fix** that addresses issues caused by the incorrect application of ARIA attributes, which could hinder assistive technologies. By correcting the ARIA role, the change **improves the accessibility** and semantic understanding of the version dropdown, ensuring a more inclusive experience for all users.

Bumped packages using @fluid-tools/benchmark to 0.51 (#24573)

This commit **improves documentation accessibility** by **updating the `alt` text** for "Learn more" links within the **Key Features section** of the documentation homepage. Specifically, it modifies the `learnMoreLinkAltText` properties in `docs/src/components/home/keyFeaturesSection.tsx` to align with the visible on-screen text rather than the destination page. This **documentation improvement** ensures greater consistency and a better experience for users, particularly those relying on screen readers.

This commit introduces **memory regression testing** to the **`tools/benchmark`** package, significantly enhancing the reliability of DDSes by proactively catching memory-related issues. It adds new properties, `baselineMemoryUsage` and `allowedDeviationBytes`, to the `MemoryTestObjectProps` interface, allowing individual memory tests to define expected memory consumption. The `benchmarkMemory` function now performs validation against these baselines, detecting both regressions and improvements. This **new capability** ensures memory usage remains stable across test runs, throwing an error if a regression is detected when the `ENABLE_MEM_REGRESSION` flag is active, or otherwise issuing a warning.

This commit **updates the `agent-scheduler` package** to adopt the **recommended Fluid Framework ESLint configuration**, enhancing code consistency and quality. As part of this **maintenance** effort, significant **refactoring** was performed within the **AgentScheduler** module, particularly in `scheduler.ts` and `taskSubscription.ts`. This refactoring primarily involved adding explicit type annotations to improve **type safety** and clarity for various methods, including `mapWait`, `load`, `haveTask`, and `volunteer`. An associated update to the `agent-scheduler.legacy.alpha.api.md` file reflects these type changes, ensuring the API report remains accurate. Overall, these changes contribute to a more robust and maintainable **`agent-scheduler`** codebase.

This commit performs a significant **refactoring** within the **ODSP driver** by **removing the `node-fetch` dependency** and migrating to the native `fetch` API. Specifically, the `fetchHelper` utility in `packages/drivers/odsp-driver/src/odspUtils.ts` was updated to directly utilize `globalThis.fetch` for network requests. This change standardizes fetch behavior and has a broad **downstream impact** on runtime requirements across the Fluid Framework. Extensive documentation updates clarify that running Fluid with the `--no-experimental-fetch` flag is no longer supported, reflecting the full adoption of native `fetch`.

This commit implements a **bug fix** addressing **accessibility violations** on the **Fluid Framework documentation website**. It **corrects the ARIA role** of the documentation version dropdown from `combobox` to `menu` within `DocsVersionDropdownNavbarItem.tsx`, ensuring proper semantic meaning for assistive technologies. Additionally, the commit **enhances link visibility** by adding an underline to all links within markdown content via `custom.scss`, making them more distinguishable from surrounding text. These **UI and accessibility improvements** contribute to better **WCAG AA compliance** and overall user experience for the documentation.

This commit **fixes an accessibility issue** by **improving the color contrast** of text within **code blocks** on the documentation site. It updates CSS variables in `docs/src/css/custom.scss` to set new text colors for both light and dark modes. This **maintenance** change specifically targets the `.token.attr-name` class, ensuring better readability for all users viewing code examples. The overall impact is a more accessible and user-friendly documentation experience.

This commit **refactors** the **`examples/external-data`** module by **replacing the `node-fetch` dependency with the native `fetch` API**. This change modernizes the network request handling within the example, **removing an external dependency** and streamlining the codebase. As a consequence of this update, the **Jest test configuration** was adjusted to include a 10-second timeout to prevent test failures. This ensures continued stability while leveraging native browser capabilities.

This commit delivers an **accessibility bug fix** by enhancing the descriptive text for screen readers on the **Fluid Framework website's home page**. It updates the `PartnerEntry`, `PartnerEntryFooter`, and `ServiceSectionCard` components in `docs/src/components/home/partnersSection.tsx` and `docs/src/components/home/serviceSection.tsx` to accept and apply more specific `aria-label` attributes. Previously generic "Learn more" links now provide context, such as the associated partner or service name, when read aloud. This significantly improves the **usability and inclusivity** of the website for visually impaired users navigating the partners and services sections.

This commit introduces a **new capability** to the **website deployment pipeline**, enabling engineers to deploy a **staging version** of the website. It modifies the `tools/pipelines/deploy-website.yml` configuration to add a `staging` option to the `deployEnvironment` parameter and sets up the corresponding API token variable. This **infrastructure enhancement** allows for manual triggering of staging builds from Azure DevOps or feature branches, providing a dedicated environment for testing and validation. The URL for the deployed staging site will be conveniently available in the deployment logs, streamlining the pre-production review process.

This commit **fixes a UI documentation test** by refining the locator for the 'Community' link within the navigation bar. The previous test was unreliable due to multiple elements sharing the same name, leading to ambiguity in the `NavBar` test. By adding a more specific specifier in `docs/test/site-tests/Nav.spec.ts`, this change **re-enables and stabilizes the test**, ensuring accurate validation of the **documentation site's navigation UI**. This is a **maintenance fix** that improves the robustness of the project's automated testing suite.

This commit **updates the search functionality** for the **Fluid Framework website** by replacing the existing Docusaurus local search package with an **accessibility-compliant fork**. This **maintenance update** specifically addresses critical **accessibility bugs** in the previous search result suggestions, such as issues with tab navigation and keyboard reachability for the "See all results" button. As a result, search result suggestions are now disabled, and users are directed to a dedicated search results page upon hitting Enter, significantly **improving keyboard accessibility** for the search feature. The change is implemented by updating the package reference from `@easyops-cn/docusaurus-search-local` to `@wayneferrao/docusaurus-search-local` in `docs/docusaurus.config.ts`.