DOCSP-26475: known issues (#32)

* DOCSP-26475: known issues

* add to toc

* AH PR fixes

* wording fix

Author: rustagir

source/includes/error-list-window.rst

@@ -1,7 +1,7 @@
 .. tip:: Error List Panel
 
-   You can view the output from the {+product+}
-   in the Visual Studio Error List Window.
+   If you are using Visual Studio for Windows, you can view the output
+   from the {+product+} in the Error List window.
 
    To learn more, see 
    `Error List Window <https://docs.microsoft.com/en-us/visualstudio/ide/reference/error-list-window?view=vs-2022>`__

source/index.txt

@@ -15,6 +15,7 @@
    Installation </install>
    /analyze-code
    Configuration </configuration>
+   /known-issues
    FAQ </faq>
    What's New </whats-new>
    Issues and Help </issues-and-help>
@@ -43,6 +44,9 @@ Read the following sections of this guide to learn how to install the
 - :ref:`Analyze your code <mongodb-analyzer-analyze-code>`
 - :ref:`Configure the extension <mongodb-analyzer-configuration>`
 
+To view known issues with the {+product+}'s current functionality, see
+the :ref:`mongodb-analyzer-known-issues` page. 
+
 To view answers to frequently asked questions, see the :ref:`FAQ <mongodb-analyzer-faq>` page.
 
 To view the differences between versions of the extension,

source/known-issues.txt

@@ -0,0 +1,32 @@
+.. _mongodb-analyzer-known-issues:
+
+============
+Known Issues
+============
+
+.. default-domain:: mongodb
+
+We are consistently working to improve the {+product+}, but we have
+identified certain issues with its current functionality. If you
+identify an issue that is not on this page, see the
+:ref:`mongodb-analyzer-issues-and-help` page for
+instructions on how to get help or report the issue.
+
+LINQ Expression Analysis on macOS
+---------------------------------
+
+If you are using the {+product+} in Visual Studio for macOS, you must
+include the following ``using`` directive at the beginning of your
+program to see analysis of LINQ expressions:
+
+.. code-block:: csharp
+
+   using MongoDB.Driver.Linq;
+
+Error List Window on macOS
+--------------------------
+
+Visual Studio for macOS does not have the Error List window feature. If
+you are using the {+product+} in Visual Studio for macOS, you will not
+be able to see output from the {+product+}, such as {+query-api+}
+translations, in one location.