From 59bfdd9a307cd69c22c956132750e2058b2872c2 Mon Sep 17 00:00:00 2001
From: Julian Ospald <hasufell@posteo.de>
Date: Wed, 25 Oct 2023 15:01:18 +0800
Subject: [PATCH] Stack docs improvement

---
 docs/guide.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/guide.md b/docs/guide.md
index 930dde33..b03abffa 100644
--- a/docs/guide.md
+++ b/docs/guide.md
@@ -281,9 +281,14 @@ url-source:
             sha256: 216b76b7c6383e6ad9ba82533f323f8550e52893a8b9fa33c7b9dc4201ac766a
 ```
 
+#### Caveats
+
 The main caveat with using this method is that there's no guarantee that GHCup will pick a compatible HLS bindist
 when you try to install HLS.
 
+Another potential usability issue is that the `latest` and `recommended` shorthands won't work anymore, since
+Stack metadata doesn't have a concept of those and we don't try to be smart when combining the metadatas.
+
 ### Windows
 
 On windows, you may find the following config options useful too: