dotnet / dotnet/docs-maui

[maui-labs docs] Remove BLE Monitoring documentation (feature reverted in maui-labs #259)

Open
#3,315 1 comment 0 reactions 0 assignees View on GitHub
:watch: Not Triaged docs-from-code Pri3
Dominant language
No language data
Stars
282
Forks
265
Avg merge
2d 2h
Merged PRs (30d)
19

Description

The BLE Monitoring feature (originally added in `dotnet/maui-labs` PR #153) has been reverted in PR #259. Any documentation created for the BLE Monitoring feature should be removed.

## Source PR

**PR**: https://github.com/dotnet/maui-labs/pull/259
**Title**: Revert "feat: BLE Monitoring" (#153)
**Author**: @jfversluis
**Merged**: 2026-05-08

## Summary of Changes

The revert removes the entire BLE Monitoring feature from DevFlow, including:

- **6 MCP tools removed**: `maui_ble_status`, `maui_ble_events`, `maui_ble_stream_url`, `maui_ble_scan_start`, `maui_ble_scan_stop`, `maui_ble_events_clear`
- **Public `AgentClient` API methods removed**: `GetBleStatusAsync()`, `GetBleEventsAsync()`, `ClearBleEventsAsync()`, `StartBleScanAsync()`, `StopBleScanAsync()`, `GetBleStreamUrlAsync()`
- **`BleTools.cs` MCP tool class removed** from `src/Cli/Microsoft.Maui.Cli/DevFlow/Mcp/Tools/`
- **Agent-side BLE monitors removed** for Android, Apple (iOS/macCatalyst), macOS, and Windows
- **API spec definitions removed** from `asyncapi.yaml`, `openapi.yaml`, and JSON schemas (`BleStatus`, `BleEvent`, `BleEventType`, `BleEventsResponse`)

## Documentation Pages Affected

If documentation was created following the original BLE Monitoring PR (#153), the following pages need to be checked and updated:

- `docs/developer-tools/devflow/` — remove any BLE Monitoring section or page
- `docs/developer-tools/devflow/mcp-tools.md` (or equivalent) — remove rows for the 6 `maui_ble_*` tools from the MCP tools table
- `docs/TOC.yml` — remove any BLE Monitoring entry

## Suggested Changes

### MCP Tools Table

If a table like the following exists, remove all `maui_ble_*` rows:

| Tool | Purpose |
|------|---------|
| ~~`maui_ble_status`~~ | ~~Get current BLE adapter status~~ |
| ~~`maui_ble_events`~~ | ~~Get captured BLE events (scan results, connections, etc.)~~ |
| ~~`maui_ble_stream_url`~~ | ~~Get WebSocket URL for live BLE event streaming~~ |
| ~~`maui_ble_scan_start`~~ | ~~Start a BLE scan~~ |
| ~~`maui_ble_scan_stop`~~ | ~~Stop the active BLE scan~~ |
| ~~`maui_ble_events_clear`~~ | ~~Clear the captured BLE event buffer~~ |

### AgentClient API Reference

If `AgentClient` BLE methods are documented, remove:
- `GetBleStatusAsync()`
- `GetBleEventsAsync(limit, type)`
- `ClearBleEventsAsync()`
- `StartBleScanAsync()`
- `StopBleScanAsync()`
- `GetBleStreamUrlAsync()`

### If a Dedicated BLE Monitoring Page Exists

Delete the page entirely and remove its entry from `docs/TOC.yml`.

> **Note**: If docs for the original BLE feature (PR #153) were never published, this issue can be closed with no action. Please verify before making changes.

> Generated by [PR Documentation Check](https://github.com/dotnet/maui-labs/actions/runs/25546019621) for issue #259 · [◷](https://github.com/search?q=repo%3Adotnet%2Fdocs-maui+is%3Aissue+%22gh-aw-workflow-call-id%3A+dotnet%2Fmaui-labs%2Fpr-docs-check%22&type=issues)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.