commit 57399cbedc34f40bc79ab4bde8ac6d9d3b2bd31d
Author: David Hewitt <davidmhewitt@users.noreply.github.com>
Date:   Wed Nov 18 16:38:31 2020 +0000

    Created Experimenting with Wayland (markdown)

diff --git a/Experimenting-with-Wayland.md b/Experimenting-with-Wayland.md
new file mode 100644
index 0000000..8711cb4
--- /dev/null
+++ b/Experimenting-with-Wayland.md
@@ -0,0 +1,30 @@
+If you are interesting in hacking on Pantheon's Wayland support, you will need to create the session files. These are:
+
+`/usr/share/wayland-sessions/pantheon-wayland.desktop` with the following contents:
+```
+[Desktop Entry]
+Name=Pantheon (Wayland)
+Comment=This session provides elementary experience
+Exec=gnome-session --builtin --session=pantheon-wayland
+TryExec=wingpanel
+Icon=
+DesktopNames=Pantheon
+Type=Application
+```
+
+And `/usr/share/gnome-session/sessions/pantheon-wayland.session` with the following contents:
+```
+[GNOME Session]
+Name=Pantheon (Wayland)
+RequiredComponents=gala-wayland;gala-daemon;org.gnome.SettingsDaemon.A11ySettings;org.gnome.SettingsDaemon.Color;org.gnome.SettingsDaemon.Datetime;org.gnome.SettingsDaemon.Housekeeping;org.gnome.SettingsDaemon.Keyboard;org.gnome.SettingsDaemon.MediaKeys;org.gnome.SettingsDaemon.Power;org.gnome.SettingsDaemon.PrintNotifications;org.gnome.SettingsDaemon.Rfkill;org.gnome.SettingsDaemon.Sharing;org.gnome.SettingsDaemon.Smartcard;org.gnome.SettingsDaemon.Sound;org.gnome.SettingsDaemon.Wacom;org.gnome.SettingsDaemon.XSettings;
+FallbackSession=pantheon
+DesktopName=Pantheon
+```
+
+Once these are created, the greeter should offer the choice between Pantheon and Pantheon (Wayland).
+
+At the time of writing, there are currently two blocking issues in Gala that cause it to hang/crash during startup when running it in Wayland mode. These are: \
+[#970](https://github.com/elementary/gala/issues/970) \
+[#971](https://github.com/elementary/gala/issues/971)
+
+Commenting out the relevant sections of the Gala code so that those classes are not initialized is enough to get the Wayland session running, but it's still far from usable after that due to Plank not being compatible with Wayland and Wingpanel not sizing/positioning itself correctly.
\ No newline at end of file