Make faqs section. Add the first question about windows shell expansion.

docs/faqs.md

@@ -0,0 +1,39 @@
+# Frequently Asked Questions
+
+```{contents}
+:depth: 2
+:local: true
+```
+
+## General
+
+### Shell Variable Expansion On Windows
+
+I have a simple Click app :
+
+```
+import click
+
+@click.command()
+@click.argument('message')
+def main(message: str):
+    click.echo(message)
+
+if __name__ == '__main__':
+    main()
+
+```
+
+When you pass an environment variable in the argument, it expands it:
+
+```{code-block} powershell
+> Desktop python foo.py '$M0/.viola/2025-01-25-17-20-23-307878'
+> M:/home/ramrachum/.viola/2025-01-25-17-20-23-307878
+>
+```
+Note that I used single quotes above, so my shell is not expanding the environment variable, Click does. How do I get Click to not expand it?
+
+#### Answer
+
+If you don't want Click to emulate (as best it can) unix expansion on Windows, pass windows_expand_args=False when calling the CLI.
+Windows command line doesn't do any *, ~, or $ENV expansion. It also doesn't distinguish between double quotes and single quotes (where the later means "don't expand here"). Click emulates the expansion so that the app behaves similarly on both platforms, but doesn't receive information about what quotes were used.

docs/index.rst

@@ -60,6 +60,11 @@ You can get the library directly from PyPI::
 Documentation
 -------------
 
+.. toctree::
+   :maxdepth: 2
+
+   faqs
+
 Tutorials
 ^^^^^^^^^^^^^
 .. toctree::