feat: Prepare v0.2.0 for release

This commit consolidates all final features and polishes for the v0.2.0 release.

- Bumps version to 0.2.0 in pyproject.toml and README.
- Adds a 'Quick Example' and 'Status' section to README.md.
- Refines warning messages and documentation for clarity.
- Adds a badge block for PyPI, Python versions, and License.

Author: aureliuscanon

README.md

@@ -8,6 +8,30 @@ A privacy-aware linter for Python projects, designed to catch accidental leaks o
 
 `privlog` is built to be a developer's first line of defense, integrating directly into your local workflow and CI/CD pipelines to enforce logging hygiene.
 
+## Why Privlog?
+
+Accidentally logging sensitive data is a common source of security and privacy issues in production systems. Tokens, user identifiers, request bodies, and other sensitive values often end up in logs during development and debugging.
+
+Privlog helps detect these risks early by scanning Python code for logging patterns that may expose sensitive data.
+
+## Quick Example
+
+Given a file `app/auth.py`:
+```python
+import logging
+
+def reauthenticate_user(user_email):
+    # ...
+    logging.info(f"Initiating re-authentication for {user_email}")
+    # ...
+```
+
+Running `privlog .` will produce the following error:
+
+```
+app/auth.py:5:5 [ERROR]    PL2101 Sensitive identifier passed to log. Hash/pseudonymize or omit.
+```
+
 ## Features
 
 - **High-Precision AST Analysis**: Goes beyond simple regex to parse Python code, understanding variable names inside f-strings, `.format()` calls, and more.
@@ -92,6 +116,13 @@ log_event = { details = "WARNING" }
 
 ---
 
+## Status
+
+Privlog is currently in early development (v0.2.0).
+Feedback and contributions are welcome.
+
+---
+
 ## For Developers
 
 To set up a development environment to contribute to `privlog`:

privlog/ast_checks.py

@@ -188,7 +188,7 @@ def visit_Call(self, node: ast.Call) -> None:
         if is_log:
             for keyword in node.keywords:
                 if keyword.arg == 'extra':
-                    self._add_finding(node, "PL2201", "Logging with 'extra' can hide sensitive data. Review manually.", "WARNING")
+                    self._add_finding(node, "PL2201", "Logging with 'extra' parameter may leak sensitive data. Please review manually.", "WARNING")
                     break
 
         # Check 3: Custom wrapper checks

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "privlog"
-version = "0.1.0"
+version = "0.2.0"
 description = "Privacy-aware logging hygiene linter for Python"
 readme = "README.md"
 requires-python = ">=3.9"