chore: organize and add comments to .gitignore

.gitignore

@@ -1,36 +1,65 @@
-.idea
-venv*
-.venv*
-env*
+
+```gitignore
+# Byte-compiled / optimized / DLL files
+*.pyc
+*.so
+
+# Distribution / packaging
+*.egg
+*.egg-info
+!/tests/**/*.egg
+/*.egg-info
+/dist/*
+build
+_build
+.mypy_cache
+.cache
+.eggs
+mellon.egg-info
+pip-wheel-metadata
 temp
 __pycache__
 *.pyc
-.DS_Store
 .cache
+.venv*
+venv*
+env*
+/releases/*
+/poetry.toml
+
+# Unit test / coverage reports
 .coverage
 coverage.xml
+.coverage
+.tox
 .pytest_cache
-.eggs
-mellon.egg-info
-scratch.py
-*.egg-info
-firebase.json
-build
-dist
-# Ignoring this for now
-/scripts
-# Ignoring log files generated by tests
+
+# Logs
 *.log
+
+# OS generated files
+.DS_Store
+
+# IDE / Editor directories and files
+.idea/*
+.python-version
+.vscode/*
+.history # vscode local history extension
+
 # Ignore some of the files that should be downloaded/generated for evaluation
 original_dataset
 eval_outputs
 /**/chitchat/user.co
 /**/banking/user.co
-.mypy_cache
-.python-version
 local_cache
+
 # Ignore example configs created in user guides
 docs/user_guides/llm/vertexai/config
 docs/**/config
-# vscode local history extension
-.history
+
+# Ignoring this for now
+/scripts
+
+# Ignoring log files generated by tests
+firebase.json
+scratch.py