Adds guide for using symbol.flag to docs (#288)

# Motivation

<!-- Why is this change necessary? -->

# Content

<!-- Please include a summary of the change -->

# Testing

<!-- How was the change tested? -->

# Please check the following before marking your PR as ready for review

- [ ] I have added tests for my changes
- [ ] I have updated the documentation or added new documentation as
needed

Author: kopekC

docs/building-with-codegen/flagging-symbols.mdx

@@ -0,0 +1,67 @@
+---
+title: "Flagging Symbols"
+description: "Learn how to use symbol flags for debugging, tracking changes, and marking code for review"
+icon: "flag"
+iconType: "solid"
+---
+
+# Flagging Symbols
+
+Symbol flags are a powerful feature in Codegen that allow you to mark and track specific code elements during development, debugging, or code review processes. Flags can be used to visually highlight code in the editor and can also integrate with various messaging systems.
+
+## Basic Usage
+
+The simplest way to flag a symbol is to call the `flag()` method on any symbol:
+
+```python
+# Flag a function
+function.flag(message="This function needs optimization")
+
+# Flag a class
+my_class.flag(message="Consider breaking this into smaller classes")
+
+# Flag a variable
+variable.flag(message="Type hints needed here")
+```
+
+When you flag a symbol, two things happen:
+1. A visual flag emoji (🚩) is added as an inline comment
+2. A `CodeFlag` object is created to track the flag in the system
+
+
+## Language-Specific Behavior
+
+The flag system adapts automatically to the programming language being used:
+
+```python
+# Python
+# Results in: def my_function():  # 🚩 Review needed
+python_function.flag(message="Review needed")
+
+# TypeScript
+# Results in: function myFunction() {  // 🚩 Review needed
+typescript_function.flag(message="Review needed")
+```
+
+
+## Example: Code Analysis
+
+Here's an example of using flags during code analysis:
+
+```python
+def analyze_codebase(codebase):
+    for function in codebase.functions:            
+        # Check documentation
+        if not function.docstring:
+            function.flag(
+                message="Missing docstring",
+            )
+            
+        # Check error handling
+        if function.is_async and not function.has_try_catch:
+            function.flag(
+                message="Async function missing error handling",
+            )
+```
+
+This feature is particularly useful when building, and iterating on the symbols that you are trying to modify.

docs/mint.json

@@ -137,6 +137,7 @@
 				"building-with-codegen/traversing-the-call-graph",
 				"building-with-codegen/react-and-jsx",
 				"building-with-codegen/codebase-visualization",
+				"building-with-codegen/flagging-symbols",
 				"building-with-codegen/calling-out-to-llms",
 				"building-with-codegen/reducing-conditions"
 			]