diff options
author | Ben Gamari <ben@smart-cactus.org> | 2023-05-01 11:52:10 -0400 |
---|---|---|
committer | Ben Gamari <ben@smart-cactus.org> | 2023-05-01 11:59:19 -0400 |
commit | 32062b6d7b51a032792368f90dc150425ccd91d1 (patch) | |
tree | 62c8a60d826d5bccaa8947e736009c7dcb3f6c88 | |
parent | 052e2bb629abc97b394b9de2394eb36cbed9385f (diff) | |
download | haskell-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.rst | 18 | ||||
-rw-r--r-- | docs/users_guide/index.rst | 1 |
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 |