FAQ.md

@@ -121,6 +121,12 @@ Then add the following to your local host table:
 
 Please contact team@openapitools.org with the details and we'll follow up with you.
 
+## Some generators are marked as beta or deprecated. What does that mean?
+
+For "beta", it means the generator is usually newly-added or not that mature in terms of functionality and feature supported.
+
+For "deprecated", it means the generator is no longer maintained due to various reasons such as languages no longer officially support (e.g. Swift 1.x). One can still use the generator or even submit PRs to improve it but users should not have any expectation in terms of the output produced by the generator.
+
 ## git
 
 ### How can I rebase my PR on the latest master?