Add more FAQs

docs/about/faq.md

@@ -15,3 +15,66 @@ your client and the LLM it's communicating with.
 We are actively exploring additional integrations based on user feedback.
 [Join the community on Discord](https://discord.gg/stacklok) to let us know
 about your favorite AI coding tool!
+
+In theory, any tool that supports one of CodeGate's provider API endpoints
+should work, however we have encountered many edge cases depending on how the AI
+assistants and agents format their prompts and expect their responses, so your
+mileage may vary.
+
+### Don't AI coding tools already redact secrets for me?
+
+It may be surprising to learn that AI coding tools don't redact secrets for you.
+Through packet captures and logging, we've seen these tools routinely sending
+secrets and PII to remote LLM providers as they collect file contents to use as
+context.
+
+### Can I use CodeGate without an internet connection?
+
+Yes, CodeGate can be used without an internet connection as long as you have a
+local LLM server running. CodeGate is designed to work with local providers like
+Ollama, LM Studio, and vLLM. Once you have downloaded the container image,
+CodeGate has no external dependencies and can be run entirely offline.
+
+### How do I know if I'm running the latest version of CodeGate?
+
+The CodeGate dashboard includes a version update check which will alert you if a
+new version is available. You can also check the latest version of CodeGate on
+our [GitHub Releases page](https://github.com/stacklok/codegate/releases). To
+upgrade, see the [upgrade instructions](../how-to/install.mdx#upgrade-codegate)
+in the installation guide.
+
+### What kind of support is available for CodeGate?
+
+We offer community support through
+[GitHub Issues](https://github.com/stacklok/codegate/issues) and our
+[Discord server](https://discord.gg/stacklok).
+
+### How do I troubleshoot issues with CodeGate?
+
+If you encounter issues with CodeGate, please check the following:
+
+- Ensure you are using the latest version of CodeGate.
+- Check the container logs for any error messages or warnings. Run
+  `docker logs codegate` to view the logs. You can also increase the logging
+  verbosity by re-launching CodeGate with `CODEGATE_APP_LOG_LEVEL` set to `INFO`
+  or `DEBUG` (see [advanced configuration](../how-to/configure.md)).
+- Search the [GitHub Issues](https://github.com/codegate/codegate/issues) for
+  similar issues or report a new issue if you can't find a solution.
+- Join our [Discord server](https://discord.gg/stacklok) to ask for help from
+  the community or the CodeGate team.
+
+### Can I use CodeGate in a team environment?
+
+Currently, CodeGate is designed to run on a single machine, but we are always
+eager to hear feedback about how you would like or expect to use CodeGate in a
+team environment. Please share your ideas/feedback in the
+[Feature Ideas section](https://github.com/stacklok/codegate/discussions/categories/feature-ideas)
+in the project's GitHub Discussions or jump into our
+[Discord server](https://discord.gg/stacklok)!
+
+### Can I contribute to CodeGate?
+
+Yes! CodeGate is an open-source project, and we welcome contributions from the
+community. You can contribute by reporting issues, submitting pull requests, or
+helping with documentation. Please check our
+[contributing guidelines](./contributing.md).

docs/development/index.md

@@ -11,3 +11,5 @@ in the main CodeGate GitHub repo.
 - [CLI commands and flags](https://github.com/stacklok/codegate/blob/main/docs/cli.md)
 - [Configuration system](https://github.com/stacklok/codegate/blob/main/docs/configuration.md)
 - [Logging system](https://github.com/stacklok/codegate/blob/main/docs/logging.md)
+- [Debugging clients](https://github.com/stacklok/codegate/blob/main/docs/debugging_clients.md)
+- [Workspaces](https://github.com/stacklok/codegate/blob/main/docs/workspaces.md)

docs/features/workspaces.mdx

@@ -36,6 +36,12 @@ Workspaces offer several key features:
   CodeGate security detections (alert history) are recorded in the active
   workspace, allowing you to track and review past interactions.
 
+- **Token usage tracking**: CodeGate tracks LLM token usage per workspace,
+  allowing you to monitor and analyze consumption across different contexts or
+  projects. For example, this feature can help you manage costs by identifying
+  high-usage workspaces or optimize API usage by adjusting prompts to reduce
+  token consumption.
+
 - **Isolation**: Configurations and data in one workspace do not affect others,
   providing clarity when reviewing your AI-assisted coding history and precision
   in tailoring your custom instructions.