summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBen Gamari <ben@smart-cactus.org>2023-05-01 11:52:10 -0400
committerBen Gamari <ben@smart-cactus.org>2023-05-01 11:59:19 -0400
commit32062b6d7b51a032792368f90dc150425ccd91d1 (patch)
tree62c8a60d826d5bccaa8947e736009c7dcb3f6c88
parent052e2bb629abc97b394b9de2394eb36cbed9385f (diff)
downloadhaskell-32062b6d7b51a032792368f90dc150425ccd91d1.tar.gz
users guide: Add glossary
Currently this merely explains the meaning of "technology preview" in the context of released features.
-rw-r--r--docs/users_guide/glossary.rst18
-rw-r--r--docs/users_guide/index.rst1
2 files changed, 19 insertions, 0 deletions
diff --git a/docs/users_guide/glossary.rst b/docs/users_guide/glossary.rst
new file mode 100644
index 0000000000..6c036f8093
--- /dev/null
+++ b/docs/users_guide/glossary.rst
@@ -0,0 +1,18 @@
+Glossary
+========
+
+technology preview::
+
+ GHC will occassionally ship features advertised as being in a *technology
+ preview* state. Such features are generally opt-in in nature (e.g. new
+ language extensions).
+
+
+ Expectation that work will continue -- unlikely to just disappear
+ Doesn’t implement all features (best to enumerate: TH…)
+ A list of known bugs/shortcomings listed here (wiki page)
+ Isn’t optimized (produces suboptimal code)
+ Behavior may change in the future, although we will try to document such changes
+
+
+
diff --git a/docs/users_guide/index.rst b/docs/users_guide/index.rst
index 15274dcc71..4bdbf13eee 100644
--- a/docs/users_guide/index.rst
+++ b/docs/users_guide/index.rst
@@ -27,6 +27,7 @@ Contents:
wasm
bugs
eventlog-formats
+ glossary
editing-guide