[libadwaita/wip/exalm/dark: 8/9] doc: Mention HdyStyleManager in migration guide

[Alexander Mikhaylenko <alexm src gnome org>]

commit ff660efe54fe392d1756934cbe483155d094535d
Author: Alexander Mikhaylenko <alexm gnome org>
Date:   Wed Sep 22 14:41:54 2021 +0500

    doc: Mention HdyStyleManager in migration guide

 doc/migrating-libhandy-1-4-to-libadwaita.md | 8 ++++++++
 1 file changed, 8 insertions(+)
---
diff --git a/doc/migrating-libhandy-1-4-to-libadwaita.md b/doc/migrating-libhandy-1-4-to-libadwaita.md
index fa3ecb1d..e1acdb65 100644
--- a/doc/migrating-libhandy-1-4-to-libadwaita.md
+++ b/doc/migrating-libhandy-1-4-to-libadwaita.md
@@ -84,6 +84,14 @@ where it's storing strings in GTK3, as the preferred replacement only exists in
 4, it can also be used with any other [struct@GObject.Value]. That use has no
 replacement and you can instead create your own objects to store those values.
 
+### Use `HdyStyleManager` instead of [property@Gtk.Settings:gtk-application-prefer-dark-theme]
+
+If your application is setting [property@Gtk.Settings:gtk-application-prefer-dark-theme]
+to `TRUE` to request dark appearance, consider setting `HdyStyleManager:color-scheme`
+to `HDY_COLOR_SCHEME_DARK_LIGHT` or `HDY_COLOR_SCHEME_DARK` instead, as needed.
+
+In libadwaita this will be the only way to request dark appearance.
+
 ## Changes that Need to Be Done at the Time of the Switch
 
 This section outlines porting tasks that you need to tackle when you get to the