Skip to content

Add docs describing how to update Mir's supported protocols on Wayland Explorer#4783

Open
mattkae wants to merge 2 commits intomainfrom
feature/wayland-explorer-how-to
Open

Add docs describing how to update Mir's supported protocols on Wayland Explorer#4783
mattkae wants to merge 2 commits intomainfrom
feature/wayland-explorer-how-to

Conversation

@mattkae
Copy link
Contributor

@mattkae mattkae commented Mar 19, 2026

What's new?

Added documentation explaining how to update Mir's json file in Wayland Explorer

How to test

Run the steps and see that it works

Checklist

  • Tests added and pass
  • Adequate documentation added
  • (optional) Added Screenshots or videos

@mattkae mattkae requested review from Saviq and tarek-y-ismail March 19, 2026 14:36
@mattkae mattkae requested a review from a team as a code owner March 19, 2026 14:36
Copilot AI review requested due to automatic review settings March 19, 2026 14:36
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds contributor documentation for updating Mir’s supported protocol listing on Wayland Explorer by generating and submitting an updated mir.json.

Changes:

  • Added a new how-to guide describing the wlprobe + miral-app workflow to regenerate mir.json
  • Linked the new guide from the contributing how-to index

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 11 comments.

File Description
doc/sphinx/contributing/how-to/index.md Adds entry for the new Wayland Explorer update guide
doc/sphinx/contributing/how-to/how-to-update-wayland-explorer.md New step-by-step instructions for generating and updating mir.json in Wayland Explorer

- [](howto-contribute)
- [](how-to-update-symbols-maps)
- [Enabling graphics on a device](how-to-enable-graphics-for-snaps-on-a-device)
- [](how-to-update-wayland-explorer)
1. Next, clone Wayland Explorer:

```sh
git clone git@github.com:vially/wayland-explorer.git
```sh
git clone git@github.com:PolyMeilex/wlprobe.git
cargo install --path wlprobe
```
Comment on lines +20 to +32
git clone git@github.com:vially/wayland-explorer.git
```

1. Next, run `miral-app` with all available Wayland extensions enbled:

```sh
WAYLAND_DISPLAY=wayland-98 miral-app --add-wayland-extension=all
```

1. Then, run `wlprobe` from the `wayland-explorer` directory:

```sh
cd wayland-explorer
Comment on lines +20 to +32
git clone git@github.com:vially/wayland-explorer.git
```

1. Next, run `miral-app` with all available Wayland extensions enbled:

```sh
WAYLAND_DISPLAY=wayland-98 miral-app --add-wayland-extension=all
```

1. Then, run `wlprobe` from the `wayland-explorer` directory:

```sh
cd wayland-explorer
Comment on lines +11 to +17

```sh
git clone git@github.com:PolyMeilex/wlprobe.git
cargo install --path wlprobe
```

1. Next, clone Wayland Explorer:
Comment on lines +11 to +17

```sh
git clone git@github.com:PolyMeilex/wlprobe.git
cargo install --path wlprobe
```

1. Next, clone Wayland Explorer:
Comment on lines +22 to +29

1. Next, run `miral-app` with all available Wayland extensions enbled:

```sh
WAYLAND_DISPLAY=wayland-98 miral-app --add-wayland-extension=all
```

1. Then, run `wlprobe` from the `wayland-explorer` directory:
Comment on lines +22 to +29

1. Next, run `miral-app` with all available Wayland extensions enbled:

```sh
WAYLAND_DISPLAY=wayland-98 miral-app --add-wayland-extension=all
```

1. Then, run `wlprobe` from the `wayland-explorer` directory:
Comment on lines +28 to +29

1. Then, run `wlprobe` from the `wayland-explorer` directory:
@Saviq
Copy link
Contributor

Saviq commented Mar 19, 2026

@copilot convert this documentation into a GitHub Actions step in spread.yaml for the lxd:...:ubuntu spread task, please

Copy link
Contributor

Copilot AI commented Mar 19, 2026

@Saviq I've opened a new pull request, #4784, to work on those changes. Once the pull request is ready, I'll request review from you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants