docs - known issues (#23522)

docs/troubleshooting-guide/bugs.md

@@ -4,7 +4,7 @@ title: Reporting a bug
 
 # Reporting a bug
 
-If you come across something that looks like a bug, please start by searching our [Github issues][metabase-issues] to see if it has already been reported. If it has, please let us know you're experiencing the same issue by reacting with a thumbs up emoji or adding a comment providing additional information.
+If you come across something that looks like a bug, please start by searching our [Github issues][metabase-issues] to see if it has already been reported. If it has, please let us know you're experiencing the same issue by reacting with a thumbs up emoji or adding a comment to provide additional information.
 
 If the bug has not yet been reported, go ahead and [open a bug report][metabase-file-bug]. The following information will help us reproduce your issue:
 
@@ -18,4 +18,4 @@ If the bug has not yet been reported, go ahead and [open a bug report][metabase-
 8. Screenshots (if relevant)
 
 [metabase-file-bug]: https://github.com/metabase/metabase/issues/new/choose
-[metabase-issues]: https://github.com/metabase/metabase/issues
\ No newline at end of file
+[metabase-issues]: ./known-issues.html#how-to-find-a-known-bug
\ No newline at end of file

docs/troubleshooting-guide/cant-log-in.md

@@ -87,7 +87,10 @@ What do you use to log in?
 
 ## Are you still stuck?
 
-If you can’t solve your problem using the troubleshooting guides, search or ask the [Metabase community][discourse].
+If you can’t solve your problem using the troubleshooting guides:
+
+- Search or ask the [Metabase community][discourse].
+- Search for [known bugs or limitations][known-issues].
 
 [cloud-docs]: /cloud/docs/
 [config-settings]: ../administration-guide/08-configuration-settings.html
@@ -101,6 +104,7 @@ If you can’t solve your problem using the troubleshooting guides, search or as
 [how-to-reset-admin-password]: ../administration-guide/04-managing-users.html#resetting-the-admin-password
 [how-to-reset-password]: ../administration-guide/04-managing-users.html#resetting-someones-password
 [incorrect-metabase-url]: #are-you-using-the-right-url-for-your-metabase
+[known-issues]: ./known-issues.html
 [ldap-docs]: ../administration-guide/10-single-sign-on.html#enabling-ldap-authentication
 [metabase-cloud-login]: #troubleshooting-metabase-cloud-logins
 [metabase-idp]: #troubleshooting-metabase-logins

docs/troubleshooting-guide/index.md

@@ -52,7 +52,8 @@ Problems, their causes, how to detect them, and how to fix them.
 
 ## Think you found a bug?
 
-Let us know by [filing a bug report][bugs].
+- [How to find known bugs or limitations][known-issues].
+- [Filing a bug report][bugs].
 
 ## Feature requests
 
@@ -97,6 +98,7 @@ Metabase adds new features and squashes bugs with each release. [Upgrading to th
 [firefox]: https://developer.mozilla.org/en-US/docs/Tools/Web_Console/Opening_the_Web_Console
 [forum]: https://discourse.metabase.com/
 [incorrect-times]: ./timezones.html
+[known-issues]: ./known-issues.html
 [ldap]: ./ldap.html
 [learn]: https://www.metabase.com/learn
 [linked-filters]: ./linked-filters.html

docs/troubleshooting-guide/known-issues.md

+---
+title: How to find a known bug or limitation
+---
+
+# How to find a known bug or limitation
+
+If you can't find or solve your problem using the [troubleshooting guides](./index.html), you may be running into an issue that we're still working on.
+
+- [How to find a known bug](#how-to-find-a-known-bug) 
+- [How to find a known product limitation](#how-to-find-a-known-product-limitation)
+
+## How to find a known bug
+
+If your work in Metabase is crashing, missing, or not being saved, you might have found a bug.
+
+1. Go to the [Metabase Github issues page](https://github.com/metabase/metabase/issues).
+
+2. Click on the **Label** dropdown and select `Type: Bug`.
+
+    > If you're encountering problems after your Metabase version was recently upgraded, you can add the label `.Regression`.
+
+3. Choose least one value in the **Label** dropdown that matches the feature you're having trouble with.
+
+    > Add additional keywords to the search bar above the list of results. Hit Enter/Return to run the search.
+
+    > Click **Sort** and select the thumbs up emoji (👍) to view the most commonly encountered bugs.
+
+4. If you find an existing bug that matches your problem, add a thumbs up emoji to help the team prioritize it.
+
+5. If you can't find your problem, and you're sure that it's not a [product limitation](#how-to-find-a-known-product-limitation), you can [create a new bug report](./bugs.html).
+
+## How to find a known product limitation
+
+If the functionality you're looking for simply doesn't exist (i.e., it hasn't suddenly gone missing), you might be running into a product limitation.
+
+1. Go to the [Metabase Github issues page](https://github.com/metabase/metabase/issues).
+
+2. Click on the **Label** dropdown and select `Type: New Feature`.
+
+3. Choose least one value in the **Label** dropdown that matches the feature you're looking for.
+
+    > Add additional keywords to the search bar above the list of results. Hit Enter/Return to run the search.
+
+    > Click **Sort** and select the thumbs up emoji (👍) to view the most highly requested features.
+
+4. If you find a feature request that matches what you want to do, add a thumbs up emoji to help the team prioritize it.
+
+5. If a feature request doesn't exist, and your issue isn't [caused by a known bug](#how-to-find-a-known-bug), you can [submit a new feature request](./requesting-new-features.html).
\ No newline at end of file

docs/troubleshooting-guide/ldap.md

@@ -88,4 +88,7 @@ If you run into an issue, check that you can login to your LDAP directory and is
 
 ## Are you still stuck?
 
-If you can’t solve your problem using the troubleshooting guides, search or ask the [Metabase community][discourse].
\ No newline at end of file
+If you can’t solve your problem using the troubleshooting guides:
+
+- Search or ask the [Metabase community](https://discourse.metabase.com/).
+- Search for [known bugs or limitations](./known-issues.html).
\ No newline at end of file

docs/troubleshooting-guide/requesting-new-features.md

@@ -33,5 +33,5 @@ Note: the more honest and specific you are here the more we will take you seriou
 
 Add any other context or screenshots about the feature request here.
 
-[github-issues]: https://github.com/metabase/metabase/labels/Type%3ANew%20Feature
+[github-issues]: ./known-issues.html#how-to-find-a-known-product-limitation
 [feature-request]: https://github.com/metabase/metabase/issues/new?assignees=&labels=.Needs+Triage%2C+Type%3ANew+Feature&template=feature_request.md
\ No newline at end of file

docs/troubleshooting-guide/sql.md

@@ -41,7 +41,10 @@ What type of [SQL variable][sql-variable-def] are you using?
 
 ## Are you still stuck?
 
-If you can’t solve your problem using the troubleshooting guides, search or ask the [Metabase community][discourse].
+If you can’t solve your problem using the troubleshooting guides:
+
+- Search or ask the [Metabase community][discourse].
+- Search for [known bugs or limitations][known-issues].
 
 [debugging-aggregations]: /learn/debugging-sql/sql-logic.html#aggregated-results-counts-sums-etc-are-wrong
 [debugging-duplicated-data]: /learn/debugging-sql/sql-logic-duplicated-data.html
@@ -49,6 +52,7 @@ If you can’t solve your problem using the troubleshooting guides, search or as
 [debugging-sql-logic]: /learn/debugging-sql/sql-logic.html
 [debugging-sql-syntax]: /learn/debugging-sql/sql-syntax.html
 [discourse]: https://discourse.metabase.com/
+[known-issues]: ./known-issues.html
 [sql-editor]: /glossary/native_query_editor.html
 [sql-variable-def]: /glossary/variable.html#example-variable-in-metabase
 [sql-variable-type]: /learn/sql-questions/sql-variables.html#the-different-types-of-variables-available-for-native-sql-queries